ngx_http_headers_module

在nginx本身原有的设置过期时间的基础上，增加了expires_by_types指令，用于根据Content-Type来设置过期时间。

原有的功能介绍看这里。

  1. 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的影响。
    如：
  1. location /url {
    expires                10s;
    expires_by_types       24s text/html;
    }

此时，/url下面的文档，text/html类型的会返回24s的过期时间，而其它类型的会返回10s的过期时间。

  1. 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则被继承了下来。

  1. expires                    10s;
    expires_by_types           24s text/html;

    location /url {
    expires off;
    expires_by_types       20s text/rss;
    }

此时，/url下面的所有文档，都不会有过期时间。

  1. expires off;
    expires_by_types           24s text/html;

    location /url {
    expires_by_types       20s text/rss;
    }

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

原文: http://tengine.taobao.org/document_cn/http_headers_cn.html