<-
Apache > HTTP Server > Documentation > Version 2.0 > Modules

Apache Модуль mod_expires

Description: поколение Expires и Cache-Control удары головой HTTP согласно пользовательским-указанным критериям
Status: расширение
Module Identifier: expires_module
Source File: mod_expires.c

резюме

этот модуль управляет урегулированием Expires удар головой HTTP и max-age директива Cache-Control удар головой HTTP в ответах сервера. Срок годности мог установить, чтобы быть или относительно времени, исходный файл был последний измененный, или ко времени доступа клиента.

Эти удары головой HTTP - инструкция клиенту о законности документа и постоянстве. Если прячется про запас, документ может быть принесен от тайника, а не из источника, пока это время не прошло. После этого, копию тайника считают "истеченной" и инвалид, и новая копия должна быть получена из источника.

изменять Cache-Control директивы кроме max-age (см. RFC 2616 section 14.9 ), Вы можете использовать Header директива.

директивы

темы

top

Alternate Interval Syntax

ExpiresDefault и ExpiresByType директивы могут также быть определены в более удобочитаемом синтаксисе формы:

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

где <base> является одним из:

plus ключевое слово является дополнительным. <num> должна быть ценность целого числа [приемлемый для atoi() ], и <type> является одним из:

например, любая из следующих директив может использоваться, чтобы заставить документы истечь спустя 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"

отметить, что, если Вы используете дату модификации, базировал урегулирование, Истекает, удар головой будет нет быть добавлен, чтобы удовлетворить, который не прибывает от файла в диск. Это - то, вследствие того, что нет никакого времени модификации для такого содержания.

top

ExpiresActive Directive

Description: позволяет поколение Expires удары головой
Syntax: ExpiresActive On|Off
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: расширение
Module: mod_expires

эта директива позволяет или калечит поколение Expires и Cache-Control удары головой для рассматриваемого царства документа. (Таким образом, если найдено в .htaccess файл, например, это применяется только к документам, произведенным от того справочника.) Если установлено в Off , удары головой не будут произведены ни для какого документа в царстве (если не отвергнуто на более низком уровне, типа .htaccess файл, отвергающий сервер config файл). Если установлено в On , удары головой будут добавлены к служившим документам согласно критериям, определенным ExpiresByType и ExpiresDefault директивы ( q.v. ).

отметить, что эта директива не гарантирует что Expires или Cache-Control удар головой будет произведен. Если критерии не будут встречены, то никакой удар головой не будут посылать, и эффект будет то, как если бы эта директива не была даже определена.

top

ExpiresByType Directive

Description: ценность Expires удар головой, формируемый типом MIME
Syntax: ExpiresByType MIME-type <code>seconds
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: расширение
Module: mod_expires

эта директива определяет ценность Expires удар головой и max-age директива Cache-Control удар головой, произведенный для документов относительно указанного типа ( например. , text/html ). Второй аргумент устанавливает число секунд, которые будут добавлены к нормативу времени, чтобы строить срок годности. Cache-Control: max-age вычислен, вычитая время запроса со срока годности и выражая результат в секундах.

норматив времени является или прошлым разом модификации файла, или временем доступа клиента к документу. То, который должен использоваться, определено <code> область; M средства, что прошлое время модификации файла должно использоваться как норматив времени, и A означает, что время доступа клиента должно использоваться.

различие в действительности является тонким. Если M используется, все текущие копии документа во всех тайниках истекут в то же самое время, который может быть хорошим кое для чего как еженедельное уведомление, которым это всегда находится в том же самом URL. Если A используется, дата истечения отлична для каждого клиента; это может быть хорошим для файлов изображения, которые не изменяются очень часто, особенно для связанных рядом документов, которые все относят к тем же самым изображениям ( то есть. , к изображениям будут получать доступ неоднократно в пределах относительно короткого промежутка).

Example:

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

отметить, что эта директива только имеет эффект если ExpiresActive On был определен. Это отвергает, для указанного типа MIME только , любой срок годности, установленный ExpiresDefault директива.

Вы можете также определить вычисление времени истечения, используя alternate syntax , описанный ранее в этом документе.

top

ExpiresDefault Directive

Description: алгоритм по умолчанию для того, чтобы вычислять время истечения
Syntax: ExpiresDefault <code>seconds
Context: сервер config, действительный хозяин, справочник, .htaccess
Override: индексы
Status: расширение
Module: mod_expires

эта директива устанавливает алгоритм по умолчанию для того, чтобы вычислить время истечения для всех документов в затронутом царстве. Это может быть отвергнуто на основании типа-типом ExpiresByType директива. См. описание той директивы для деталей о синтаксисе аргумента, и alternate syntax описание также.