[+]文章目录
ngx_http_headers_module

在nginx本身原有的设置过期时间的基础上,增加了expires_by_types指令,用于根据Content-Type来设置过期时间。
原有的功能介绍看这里

expires_by_types       24h text/html;
    expires_by_types       modified +24h text/xml;
    expires_by_types       @15h30m text/xml;
    expires_by_types       0 text/xml;
    expires_by_types       -1 text/xml;
    expires_by_types       epoch text/xml;
指令
Syntax: expires_by_types [[modified] time | @time-of-day | epoch | max | off] content-type1
                  [content-type2] [content-type3] ...
Default: -
Context: http, server, location

该指令配置过期时间及其对应的content-type。过期时间的配置可参考expires的配置。在配置时间之后,可加上一到多个content-type。

注意,在即有expires也有expires_by_types出现时,规则如下:

  • 在 同一级别中,如果同时出现expires与expires_by_type时,出现在expires_by_type中的content-type会优先 选择expires_by_types中配置的,而没有出现在content-type中的,会选择expires中配置的;
  • 当本级别与上一级别都没有配置expires off时,expires与expires_by_types当本级别没有配置时分配继承上一级别的配置信息,然后再按照规则一执行;
  • 当本级别配置有expires off时,此时模块会忽略expires_by_types的所有配置,并禁用掉expires;
  • 当本级别没有配置expires,而上一级别有配置expires off时,本级别的expires_by_types将不受上一级别的expires的影响。
如:
location /url {
        expires                10s;
        expires_by_types       24s text/html;
    }
此时,/url下面的文档,text/html类型的会返回24s的过期时间,而其它类型的会返回10s的过期时间。
expires                    10s;
    expires_by_types           24s text/html;

    location /url {
        expires_by_types       20s text/rss;
    }
此时,/url下面的文档,text/rss类型的会返回20s的过期时间,而其它类型的会返回10s的过期时间。因为location里面的expires_by_types将上层的expires_by_types覆盖了。而expires 10s则被继承了下来。
expires                    10s;
    expires_by_types           24s text/html;

    location /url {
        expires off;
        expires_by_types       20s text/rss;
    }
此时,/url下面的所有文档,都不会有过期时间。
expires off;
    expires_by_types           24s text/html;

    location /url {
        expires_by_types       20s text/rss;
    }
此时,/url下面的文档,text/rss类型的会返回20s的过期时间,其它类型的没有过期时间。注意,expires off不会继承过来。

« 前一篇