Please note

This document refers to the 2.0 version of Apache httpd, which is no longer maintained. Upgrade, and refer to the current version of httpd instead, documented at:

Current release version of Apache HTTP Server documentation

You may follow this link to go to the current version of this document.

아파치 모듈 mod_expires

가능한 언어: en | 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 절 참고)를 수정할 수 있다.

주제

다른 내부 문법

다른 내부 문법

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 지시어를 사용하여 종류별로 설정할 수 있다. 아규먼트 문법에 대한 자세한 설명은 그 지시어와 다른 문법을 참고하라.