资讯专栏INFORMATION COLUMN

Nginx 操作响应头信息

MkkHou / 1286人阅读

摘要:意思为将自定义的头信息添加到响应头的末尾,指令为,可以用在上下文中,只有当响应状态码等于或时生效,如果参数指定了,头信息将无视状态码,在所有响应中强制返回。参数禁用添加或修改和响应头字段。

原文链接:何晓东 博客

前置条件:需要编译 ngx_http_headers_module 模块,才支持 header 头信息操作
add_header

意思为将自定义的头信息的添加到响应头,指令为 add_header name value [always];,可以用在 http {}, server {}, location {}, if in location {} 上下文中,
只有当响应状态码等于 200, 201 (1.3.10), 204, 206, 301, 302, 303, 304, 307 (1.1.16, 1.0.13), 或 308 (1.13.0) 时生效,如果 always 参数指定了,头信息将无视状态码,在所有响应中强制返回。

注意: 可以声明多个 add_header 指令,当且仅当 当前区块没有 add_header 的时候,才会继承上级声明的 add_header 信息

例如:

server {
    add_header a 123;

    location / {
        root /path;
    }

    location /download/ {
        add_header b 321;
    }
}

如上的例子,在访问 /download/ 路由的时候,将返回 b 321 这样的头信息,而访问 / 路由时,将返回上级指定的 a 123 头信息。

add_trailer

意思为将自定义的头信息添加到响应头的末尾,指令为 add_trailer name value [always];,可以用在 http {}, server {}, location {}, if in location {} 上下文中,只有当响应状态码等于 200, 201, 206, 301, 302, 303, 307, 或 308 时生效,如果 always 参数指定了,头信息将无视状态码,在所有响应中强制返回。

注意: 可以声明多个 add_trailer 指令,当且仅当 当前区块没有 add_trailer 的时候,才会继承上级声明的 add_trailer 信息

举例参考 add_header 的例子。

expires

启用或禁用,添加或修改响应头中的 "Expires" 和 "Cache-Control" 字段,指令为 expires [modified] time; 或者 expires epoch | max | off; 当响应状态码等于200, 201 (1.3.10), 204, 206, 301, 302, 303, 304, 307 (1.1.16, 1.0.13), 或 308 (1.13.0) 时生效,time 参数可以为正时间或者负时间。"Expires" 字段中的时间计算为当前时间和在 time 中指定的时间总和。如果使用该 modified 参数(0.7.0,0.6.32),则将时间计算为文件修改时间与 time 指令中指定的时间之和。

此外,可以使用 "@" 前缀(0.7.9,0.6.34)指定一天中的时间:expires @15h30m;

"Cache-Control" 字段的内容取决于指定时间的符号:

时间为负数 - "Cache-Control: no-cache"

时间为正数或者0 - "Cache-Control: max-age=t" t 是指令中指定的时间,以秒为单位

epoch 参数将 "Expires" 设置为值 "Thu, 01 Jan 1970 00:00:01 GMT",将"Cache-Control" 设置为 "no-cache"。

max 参数将 "Expires" 设置为值 "Thu, 31 Dec 2037 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;

© 主体内容翻译自 Module ngx_http_headers_module docs, 做了一些调整和示例

大佬们,点这个链接进入知识的宝库 ,绝对超值

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/40456.html

相关文章

  • Nginx 操作响应信息

    摘要:意思为将自定义的头信息添加到响应头的末尾,指令为,可以用在上下文中,只有当响应状态码等于或时生效,如果参数指定了,头信息将无视状态码,在所有响应中强制返回。参数禁用添加或修改和响应头字段。 原文链接:何晓东 博客 前置条件:需要编译 ngx_http_headers_module 模块,才支持 header 头信息操作 add_header 意思为将自定义的头信息的添加到响应头,指令为...

    happen 评论0 收藏0
  • Nginx实践篇(5)- Nginx代理服务 - 代理缓冲区、代理重新定义请求、代理连接超时

    摘要:由缓冲区数量和缓冲区大小组成的。重新定义或添加传递给代理服务器的请求头允许重新定义或添加传递给代理服务器的请求头。定义了将请求发送到代理服务器的超时时间,默认为秒。 1. 代理缓冲区 代理服务器可以缓存一些响应数据,来减少I/O损耗,数据默认存储在内存中,当内存不够时,会存储到硬盘上。 proxy_buffering proxy_buffering这个参数用来控制是否打开后端响应内容的...

    BDEEFE 评论0 收藏0
  • Nginx实践篇(5)- Nginx代理服务 - 代理缓冲区、代理重新定义请求、代理连接超时

    摘要:由缓冲区数量和缓冲区大小组成的。重新定义或添加传递给代理服务器的请求头允许重新定义或添加传递给代理服务器的请求头。定义了将请求发送到代理服务器的超时时间,默认为秒。 1. 代理缓冲区 代理服务器可以缓存一些响应数据,来减少I/O损耗,数据默认存储在内存中,当内存不够时,会存储到硬盘上。 proxy_buffering proxy_buffering这个参数用来控制是否打开后端响应内容的...

    Godtoy 评论0 收藏0
  • 跨域问题汇总

    摘要:因为浏览器的同源策略,前端开发会遇到各种跨域问题。前言在总结各种跨域问题之前,我们先来了解一下浏览器的同源策略。所以只能解决一级域名相同二级域名不同的跨域问题。 跨域问题的场景和解决方案多种多样,只要是做前端开发,总会遇到。而且面试时也是必问的问题。所以自己学习总结记录一下。 因为浏览器的同源策略,前端开发会遇到各种跨域问题。本篇文章总结了遇到跨域问题的不同的场景以及对应的解决方案。 ...

    MkkHou 评论0 收藏0

发表评论

0条评论

MkkHou

|高级讲师

TA的文章

阅读更多
最新活动
阅读需要支付1元查看
<