Apache: Модуль Apache mod

RU EN

Пункт 140. Модуль Apache mod_expires

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

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

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

Когда Expires заголовок уже является частью ответа, сгенерированного сервером, например, когда он сгенерирован сценарием CGI или передан через прокси с исходного сервера, этот модуль не изменяет и не добавляет заголовок Expires или Cache-Control .

Синтаксис альтернативного интервала

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

 ExpiresDefault " база [плюс числовой  тип ] [ числовой  тип ] ..."
ExpiresByType тип/кодировка " база [плюс числовой  тип ] [ числовой  тип ] ..."

где база является одним из:

access
now (эквивалент ' access ')
modification

Ключевое plus слово является необязательным. num должно быть целым числом [допустимым для atoi() ], а тип — одним из:

years
months
weeks
days
hours
minutes
seconds

Например, любая из следующих директив может быть использована для того, чтобы срок действия документов истекал через 1 месяц после доступа по умолчанию:

 ExpiresDefault "доступ плюс 1 месяц"
ExpiresDefault "доступ плюс 4 недели"
ExpiresDefault "доступ плюс 30 дней"

Время истечения можно точно настроить, добавив несколько предложений ' num type ':

 ExpiresByType text/html "доступ плюс 1 месяц 15 дней 2 часа"
ExpiresByType image/gif "модификация плюс 5 часов 3 минуты"

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

Директива ExpiresActive

Описание:	Позволяет генерировать `Expires` заголовки
Синтаксис:	`ExpiresActive On\|Off`
По умолчанию:	`ExpiresActive Off`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Переопределить:	Индексы
Положение дел:	Расширение
Модуль:	mod_expires

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

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

Директива ExpiresByType

Описание:	Значение заголовка, `Expires` настроенное по типу MIME
Синтаксис:	`ExpiresByType MIME-type <code>seconds`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Переопределить:	Индексы
Положение дел:	Расширение
Модуль:	mod_expires

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

Базовое время — это либо время последней модификации файла, либо время обращения клиента к документу. Что следует использовать, определяется полем ; означает, что в качестве базового времени следует использовать время последней модификации файла, а также означает, что следует использовать время доступа клиента. <code> M A

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

Пример:

 # включить истечение срока действия
ExpiresActive On
# Срок действия GIF-изображений через месяц в кеше клиента
ExpiresByType image/gif A2592000
# Документы в формате HTML годны в течение недели с момента
# раз они были изменены
ExpiresByType текст/html M604800

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

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

Директива ExpiresDefault

Описание:	Алгоритм по умолчанию для расчета времени экспирации
Синтаксис:	`ExpiresDefault <code>seconds`
Контекст:	конфигурация сервера, виртуальный хост, каталог, .htaccess
Переопределить:	Индексы
Положение дел:	Расширение
Модуль:	mod_expires

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