Apache HTTP Server Version 2.0
![](feather.gif)
아파치 모듈 mod_expires
설명: | 사용자가 지정한 기준에 따라 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 절 참고)를 수정할 수 있다.
다른 내부 문법
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
지시어를
사용하여 종류별로 설정할 수 있다. 아규먼트 문법에 대한
자세한 설명은 그 지시어와 다른 문법을
참고하라.