mod_expires - Apache HTTP Server Version 2.4

Apache HTTP Server Version 2.4

Apache > HTTP Server > Documentation > Version 2.4 > 모듈

# 아파치 모듈 mod_expires

가능한 언어: en | fr | ja | ko

이 문서는 최신판 번역이 아닙니다. 최근에 변경된 내용은 영어 문서를 참고하세요.

설명: | 사용자가 지정한 기준에 따라 `Expires`와 `Cache-Control` HTTP 헤더를 생성한다
상태: | Extension
모듈명: | expires_module
소스파일: | mod_expires.c

### 요약

이 모듈은 서버 응답의 `Expires` HTTP 헤더와 `Cache-Control` HTTP 헤더의 `max-age` 지시어 설정을 조절한다. 만기일을 파일이 마직막 수정된 시간 혹은 클라이언트가 접속한 시간에 상대적으로 설정할 수 있다.

이 HTTP 헤더들은 클라이언트에게 문서의 유효성과 지속성을 알려준다. 이 시간이 아직 지나지않았다면, 문서를 캐쉬에서 가져와도 된다. 만기일이 지났다면 캐쉬된 것을 "만료되고" 유효하지 않다고 간주하여, 소스에서 문서를 새로 얻어와야 한다.

`Header` 지시어를 사용하여 `max-age` 외의 다른 `Cache-Control` 지시어(RFC 2616, 14.9 절 참고)를 수정할 수 있다.

### 주제

- 다른 내부 문법

### 지시어들

### Bugfix checklist

- httpd changelog
- Known issues
- Report a bug

### 참고

- Comments

## 다른 내부 문법

`ExpiresDefault`와 `ExpiresByType` 지시어를 더 읽기 좋은 형식으로 기술할 수 있다:

`ExpiresDefault "<base> [plus] {<num> <type>}*"
ExpiresByType type/encoding "<base> [plus] {<num> <type>}*"`

<base>는 다음중 하나이다:

- `access`
- `now` ('`access`'와 같음)
- `modification`

`plus` 키워드는 없어도 된다. <num>은 [`atoi()`에 사용할 수 있는] 정수값이다. <type>은 다음중 하나이다:

- `years`
- `months`
- `weeks`
- `days`
- `hours`
- `minutes`
- `seconds`

예를 들어, 다음 모두는 문서가 기본적으로 접속된지 1달후에 만기된다고 설정한다:

`ExpiresDefault "access plus 1 month"
ExpiresDefault "access plus 4 weeks"
ExpiresDefault "access plus 30 days"`

'<num> <type>' 구문을 반복해서 사용하여 만기시간을 자세히 설정할 수 있다:

`ExpiresByType text/html "access plus 1 month 15 days 2 hours"
ExpiresByType image/gif "modification plus 5 hours 3 minutes"`

만약 수정시간(modification)을 기준으로 만기시간을 설정하는 경우 내용을 디스크에 있는 파일에서 가져오지 않는다면 Expires 헤더를 붙이지 않는다. 이 경우 내용에 수정시간이 없기 때문이다.

## ExpiresActive 지시어

설명: | `Expires` 헤더를 생성한다
문법: | `ExpiresActive On|Off`
사용장소: | 주서버설정, 가상호스트, directory, .htaccess
Override 옵션: | Indexes
상태: | Extension
모듈: | mod_expires

이 지시어는 해당 영역에 대해 (즉, `.htaccess` 파일에서 사용한다면 그 디렉토리 아래에 있는 문서들만 해당된다.) `Expires`와 `Cache-Control` 헤더를 생성할지 유무를 결정한다. (`.htaccess` 파일 등으로 더 하위 단계에서 서버설정을 변경하지않는 한) `Off`이면 해당 영역에 있는 문서에 이들 헤더를 생성하지 않는다. `On`이면 `ExpiresByType`과 `ExpiresDefault` 지시어로 (해당 항목을 참고하라) 지정한 규칙에 따라 서비스하려는 문서에 이 헤더들을 생성한다.

이 지시어가 `Expires`나 `Cache-Control` 헤더를 보장하지는 않는다. 규칙에 해당하지 않다면 마치 이 지시어가 없는 것처럼 헤더를 만들지 않는다.

## ExpiresByType 지시어

설명: | MIME type으로 `Expires` 헤더값을 설정한다
문법: | `ExpiresByType MIME-type <code>seconds`
사용장소: | 주서버설정, 가상호스트, directory, .htaccess
Override 옵션: | Indexes
상태: | Extension
모듈: | mod_expires

이 지시어는 특정 종류의 (에를 들어, `text/html`) 문서에 대한 `Expires` 헤더값과 `Cache-Control` 헤더의 `max-age` 지시어값을 정의한다. 두번째 아규먼트는 만기시간을 결정할때 기준 시간에 더할 초단위 값을 지정한다. `Cache-Control: max-age`는 만기시간에서 요청한 시간을 빼서 계산하고, 결과는 초단위로 표시한다.

기준 시간은 파일의 최근 수정시간 혹은 클라이언트가 문서에 접근한 시간이다. 이떤 것을 사용할지는 `<code>` 필드로 결정해야 한다. `M`은 기준 시간으로 파일의 최근 수정시간을 사용하고, `A`는 클라이언트의 접근 시간을 사용한다.

차이는 미묘하다. `M`을 사용하면 캐쉬에 있는 모든 복사본이 같은 시간에 만료된다. 그래서 항상 같은 URL로 찾아볼 수 있는 주간일정 같은 용도에 좋다. `A`를 사용하면 복사본의 만기시간이 각각 다르다. 이는 자주 수정되지않는 그림파일에, 특히 여러 문서에서 같은 그림을 참조할때 (예를 들어, 이미지는 상대적으로 짧은 기간동안 반복해서 접근된다), 유용하다.

### 예제:

`# 만기헤더를 사용한다
ExpiresActive On
# 클라이언트 캐쉬의 GIF 그림은 한 달후에 만기한다
ExpiresByType image/gif A2592000
# HTML 문서는 변경후 일주일간 유효하다 ExpiresByType text/html M604800`

이 지시어는 `ExpiresActive On`을 사용할때만 유효함을 주의하라. `ExpiresDefault` 지시어를 사용하여 특정 MIME type에 대해서만 만기시간을 설정할 수 있다.

앞에서 설명한 다른 문법을 사용하여 만기시간을 계산할 수도 있다.

## ExpiresDefault 지시어

설명: | 만기시간을 계산하는 기본 알고리즘
문법: | `ExpiresDefault <code>seconds`
사용장소: | 주서버설정, 가상호스트, directory, .htaccess
Override 옵션: | Indexes
상태: | Extension
모듈: | mod_expires

이 지시어는 해당 영역에 있는 모든 문서의 만기시간을 계산하는 기본 알고리즘을 지정한다. `ExpiresByType` 지시어를 사용하여 종류별로 설정할 수 있다. 아규먼트 문법에 대한 자세한 설명은 그 지시어와 다른 문법을 참고하라.

가능한 언어: en | fr | ja | ko