[APACHE DOCUMENTATION]

Apache HTTP Server Version 1.3

Module mod_expires

This module is contained in the 이 모듈은 mod_expires.c 파일안에 포함되어 있으며, 기본 모듈로 컴파일 되어 있지 않습니다. 이 모듈은 사용자가 정의한 기준에 의해서 Expires 헤더는 생성하기 위해 제공됩니다.

Summary

이 모듈은 클라이언트 요청에 따라 전송되는 서버응답에서 Expires HTTP 헤더의 셋팅을 제어한다. 만료일자(expiration date)는 소스파일의 마지막 수정날자나 클라이언트가 마지막으로 접속한 시간에 대해서 설정될 수 있다.

Expires HTTP header 는 문서의 유효기간과 지속성에 대해 알려준다. 만약 캐쉬 되어 있다면 클라이언트는 유효기간이 지날때까지 소스로 부터 문서를 가져오지 않고, 캐쉬되어 있는 문서를 열것이다. 후에, 캐쉬 복사본이 만료( "expired" )되면, 소스로 부터 새로운 복사본을 캐쉬로 사용하게 된다.

Directives

ExpiresActive directive

Syntax: ExpiresActive boolean
Context: server config, virtual host, directory, .htaccess
Override: Indexes
Status: Extension
Module: mod_expires

이 다이렉티브는 ExpiresByType,ExpiresDefault의 설정을 On,Off한다. On으로 설정되면 ExpiresBytype또는 ExpiresDefault의 설정값을 따른다.

Off로 설정되면 물론 설정된 값을 참조하지 않는다.

　

이 선언은 문서 부문을 위한 Expires header 의 생성 여부를 지정한다. ( 만약 .htaccess file 에서 이 선언을 하게 되면 해당 디렉토리에 있는 문서에 대해서만 적용된다. ) Off 로 지정되면 Expires header 는 생성되지 않으며 ( .htaccess file 과 같이 하위 수준에서 서버설정이 덮어씌어진 경우 제외 ) On, 일 경우 ExpiresByType and ExpiresDefault directives 에 의해 정의된 기준에 따라 제공되는 문서에 Expires header 를 추가한다(q.v.).

for the document realm in question. (That is, if found in an .htaccess file, for instance, it applies only to documents generated from that directory.) If set to Off, no Expires header will be generated for any document in the realm (unless overridden at a lower level, such as an .htaccess file overriding a server config file). If set to On, the header will be added to served documents according to the criteria defined by the ExpiresByType and ExpiresDefault directives (q.v.).

이 선언으로만  Expires header 가 생성되었다고 장담할 수 없다. 만약 기준이 주어지지 않는다면 헤더는 보내지지 않고, 이 선언은 아무 효과가 없어진다.

ExpiresByType directive

Syntax: ExpiresByType MIME-type <code>seconds
Context: server config, virtual host, directory, .htaccess
Override: Indexes
Status: Extension
Module: mod_expires

이 선언은 만료일자를 설정하는 것으로서, MIME-type-특정형식(e.g., text/html)의 문서에 대해 생성되는 Expires header 값을 정의한다. 두번째 인수(시간,초단위)는 기본시간에 덧붙여 추가될 시간으로, 만료일자 = 기본시간 + 시간(초단위) 이다.

기본시간은 화일의 마지막 수정 날짜 또는 클라이언트가 접속한 당시의 시간등으로 <code> 필드에 의해서 지정된다(초단위 시간앞에 붙임).  M 은 전송될 파일의 최종 수정 시간을 기초로 만료일자를 정하는 방식이며, A 는 클라이언트가 Access(접속)한 시간을 사용한다.

이 효과의 차이는 미묘하다. 만약 M 이 사용되면, 현재 캐쉬된 모든 복사본은 동시에 기간이 만료될 것이다. 이런것은 주간으로 업데이트 되는 공지사항 ( - 같은 URL 에서 ) 같은 text/html 문서에 좋다. A 가 사용되었다면, 만료 날짜는 클라이언트 마다 다를 것이다. 이것은 자주 바뀌지 않는 이미지에 유리하다..(i.e., 이미지는 상대적으로 짧은 시간안에 억세스 될 것이다.).

Example:   

   ExpiresActive On                  # enable expirations
   ExpiresByType image/gif A2592000  # expire GIF images after a month
                                     #  in the client's cache
   ExpiresByType text/html M604800   # HTML documents are good for a
                                     #  week from the time they were
                                     #  changed, period

이 선언은 ExpiresActive On 로 지정된 경우에만 효과가 있으며,  단지 지정된 MIME type 만 적용 된다. 지정되지 않은 다른 파일형식에 대해서는 ExpiresDefault directive 에서 선언된 내용을 기본값으로 따른다.

또한 alternate syntax 를 사용해서 만료날짜를 지정할 수 있다.

ExpiresDefault directive

Syntax: ExpiresDefault <code>seconds
Context: server config, virtual host, directory, .htaccess
Override: Indexes
Status: Extension
Module: mod_expires

이 선언은 ExpiresByType directive 에 의해 정의되지 않은 나머지 모든 MIME-TYPE의 만료날자를 설정한다. 파일형식(MIME) 별로 override 될 수 있다. 인수의 syntax 에 대한 자세한 선언 은  alternate syntax 참고.

Alternate Interval Syntax

  ExpiresDefault 와 ExpiresByType directives 는 또한 다음과 같은 읽기 쉬운 형식으로 정의할 수 있습니다.:

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

<base>에는 기본시간의 생성방벙을 결정하는 값으로 다음과 같은 값 중 하나를 사용한다.:

'plus' 키워드는 옵션으로. <num> 에는 <type>에따라 허용될 수 있는 정수를 사용하며 , <type> 에는 다음중 하나를 사용한다.:

예를 들어, 만료일자의 기본값을 문서에 액서스 한지 한달이 지나는 날로 지정하는 예이다.:

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 date(수정날짜)를 기본 셋팅으로 사용 했다면, Expires header 는 디스크의 파일로 부터온 컨텐츠에 대해서는 추가되지 않는다. 이것은 그런 컨텐츠에는 최종수정일자가 없기 때문이다. 

Apache HTTP Server Version 1.3

Index Home