ngx_http_headers_module

• 指令
  • add_header
  • add_trailer
  • expires

ngx_http_headers_module 模块允许将 Expires 和 Cache-Control 头字段以及任意字段添加到响应头中。

示例配置

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

指令

add_header

如果响应代码等于 200、201（1.3.10）、204、206、301、302、303、304、307（1.1.16、1.0.13）或 308（1.13.0），则将指定的字段添加到响应报头中。该值可以包含变量。

可以存在几个 add_header 指令。当且仅当在当前级别上没有定义 add_header 指令时，这些指令才从上一级继承。

如果指定了 always 参数（1.7.5），则无论响应代码为何值，头字段都将被添加。

add_trailer

如果响应代码等于 200、201、206、301、302、303、307 或 308，则将指定的字段添加到响应的末尾。该值可以包含变量。

可以存在多个 add_trailer 指令。当且仅当在当前级别上没有定义 add_trailer 指令时，这些指令才从上一级继承。

如果指定 always 参数，则无论响应代码为何值，都会添加指定的字段。

expires

如果响应代码等于 200、201（1.3.10）、204、206、301、302、303、304
307（1.1.16、1.0.13）或 308（1.13.0），则启用或禁用添加或修改 Expires 和 Cache-Control 响应头字段。参数可以是正值或负值。

Expires字段中的时间计算为指令中指定的time和当前时间的总和。如果使用modified参数（0.7.0、0.6.32），则计算时间为文件修改时间与指令中指定的time` 之和。

另外，可以使用 @ 前缀指定一天的时间（0.7.9、0.6.34）：

expires @15h30m;

epoch 参数对应于绝对时间 Thu, 01 Jan 1970 00:00:01 GMT。Cache-Control 字段的内容取决于指定时间的符号：

• 时间为负值 — Cache-Control:no-cache
• 时间为正值或为零 — Cache-Control:max-age=t，其中 t 是指令中指定的时间，单位为秒

max 参数将 Expires 的值设为 Thu, 2037 Dec 23:55:55 GMT，Cache-Control 设置为 10 年。

off 参数禁止添加或修改 Expires 和 Cache-Control 响应头字段。

最后一个参数值可以包含变量（1.7.9）：

map $sent_http_content_type $expires {
    default         off;
    application/pdf 42d;
    ~image/         max;
}

expires $expires;