Модуль ngx_http_headers_module

Разделы

Пример конфигурации
Директивы
     add_header
     expires

Модуль ngx_http_headers_module позволяет выдавать поля заголовка “Expires” и “Cache-Control”, а также добавлять произвольные поля в заголовок ответа.

Пример конфигурации

expires    24h;
expires    modified +24h;
expires    @24h;
expires    0;
expires    -1;
expires    epoch;
add_header Cache-Control private;

Директивы

синтаксис: add_header имя значение;
умолчание:
контекст: http, server, location, if в location

Добавляет указанное поле в заголовок ответа при условии, что код ответа равен 200, 201, 204, 206, 301, 302, 303, 304 или 307. В значении можно использовать переменные.

Директив add_header может быть несколько. Директивы наследуются с предыдущего уровня при условии, что на данном уровне не описаны свои директивы add_header.

синтаксис: expires [modified] время;
expires epoch | max | off;
умолчание:
expires off;
контекст: http, server, location, if в location

Разрешает или запрещает добавлять или менять поля “Expires” и “Cache-Control” в заголовке ответа при условии, что код ответа равен 200, 201, 204, 206, 301, 302, 303, 304 или 307. В качестве параметра можно задать положительное или отрицательное время.

Время в поле “Expires” получается как сумма текущего времени и времени, заданного в директиве. Если используется параметр modified (0.7.0, 0.6.32), то время получается как сумма времени модификации файла и времени, заданного в директиве.

Кроме того, с помощью префикса “@” можно задать время суток (0.7.9, 0.6.34):

expires @15h30m;

Параметр epoch соответствует абсолютному времени “Thu, 01 Jan 1970 00:00:01 GMT” (1 января 1970 года 00:00:01 GMT). Содержимое поля “Cache-Control” зависит от знака заданного времени:

  • отрицательное время — “Cache-Control: no-cache”.
  • положительное или равное нулю время — “Cache-Control: max-age=t”, где t это время в секундах, заданное в директиве.

Параметр max задаёт время “Thu, 31 Dec 2037 23:55:55 GMT” (31 декабря 2037 23:55:55 GMT) для поля “Expires” и 10 лет для поля “Cache-Control”.

Параметр off запрещает добавлять или менять поля “Expires” и “Cache-Control” в заголовке ответа.

    Поддержать сайт на родительском проекте КГБ