nginx的ngx_http_sub_module模块详解

 

一、介绍

该ngx_http_sub_module模块是一个过滤器，通过将一个指定的字符串替换为另一个字符串来修改响应。该模块不是默认生成的，它应该使用--with-http_sub_module 配置参数启用 。

二、指令介绍

2.1、sub_filter指令

作用：用于替换字符串

用法：sub_filter   要替换的字符串   替换后的字符串，不区分字符串的大小写

范围：http   server   location

默认：-

2.2、sub_filter_last_modified指令

作用：允许在替换期间保留来自原始响应的“Last-Modified”标题字段以促进响应缓存。默认情况下，在处理期间修改响应的内容时，标题字段被删除。

用法：sub_filter_last_modified  on | off

范围：http   server   location

默认：sub_filter_last_modified  on

 2.3、sub_filter_once

作用：指示是否查找每个字符串以替换一次或重复替换。

用法：sub_filter_once  on | off

范围：http   server   location

默认：http   server   location

2.4、sub_filter_types

作用：指定MIME类型的字符串替换，除了“ text/html” 之外，还可以在指定MIME类型的响应中启用字符串替换。特殊值“ *”匹配任何MIME类型

用法：sub_filter_types mime-type ...

范围：http   server   location

默认：sub_filter_types text / html;