在nginx本身原有的设置过期时间的基础上,增加了expires_by_types指令,用于根据Content-Type来设置过期时间。
原有的功能介绍看这里。
expires_by_types 24h text/html; |
指令
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 { |
此时,/url下面的文档,text/html类型的会返回24s的过期时间,而其它类型的会返回10s的过期时间。
expires 10s; |
此时,/url下面的文档,text/rss类型的会返回20s的过期时间,而其它类型的会返回10s的过期时间。因为location里面的expires_by_types将上层的expires_by_types覆盖了。而expires 10s则被继承了下来。
expires 10s; |
此时,/url下面的所有文档,都不会有过期时间。
expires off; |
此时,/url下面的文档,text/rss类型的会返回20s的过期时间,其它类型的没有过期时间。注意,expires off不会继承过来。