本文介绍一个nginx第三方模块nginx_substitutions_filter,此模块作用是替换过滤响应主体,nginx也有一个类似这样的原生模块(http_sub_module),但有一个缺点,就是只能使用一条规则,而nginx_substitutions_filter则不限规则数量(测试效率比原生模块稍慢一点)。


安装方法

    1.svn checkout http://substitutions4nginx.googlecode.com/svn/trunk/ substitutions4nginx-read-only

    2.yum install subversion


----------------------------------------------------------

由于其他一些原因,可能您无法连接到googlecode  那么我这里已经有打包好的tar包,解压出来然后重新编译安装nginx即可   下载地址:http://pan.baidu.com/s/1pJBMk2Z   2014新版下载地址:

http://pan.baidu.com/s/1c0rPPj6

原googlecode版本好像已经停止更新了,作者似乎迁移到GitHub上了,https://github.com/yaoweibin/ngx_http_substitutions_filter_module/

最近更新是 2014.02.15   添加了

subs_filter_bypass

-------------------------------------------------------------


编译添加额外第三方模块的方法

cd   nginx/
./configure --add-module=path/substitutions4nginx-read-only

这里的path 是substitutions4nginx-read-only 的目录路径

make  &&  make install


用法:

    有两条指令:subs_filter_types,subs_filter

    subs_filter_types

    语法: subs_filter_types mime-type [mime-types]

    默认:subs_filter_types text/html (高版本的nginx如果有写着条,那么重启服务的时候会有警告信息,因为默认就是检查 text/html的信息,与程序有重复配置)

    适用区域:http, server, location

    subs_filter_types是用来指令需要替换的文件类型,默认是text/html类型。此模块无法处理经过压缩的内容,虽然能与gzip filter模块兼容,但无法处理反向代理返回的内容。当需要处理反向代理的内容时,可以使用如下语句禁用压缩:

 

   proxy_set_header Accept-Encoding '';


    subs_filter

    语法;subs_filter 源字段串 目标字段串 [gior]

    默认:无

    适用区域:http, server, location

    subs_filter指令允许在nginx响应输出内容时替换源字段串(正则或固定)为目标字符串。第三个标志含意如下:

    g(默认): 替换所有匹配的字段串。(默认可省略)

    i: 执行区分大小写的匹配。

    o: 仅替换首个匹配字符串。

    r: 使用正则替换模式,默认是固定模式。


模块官网:

https://github.com/yaoweibin/ngx_http_substitutions_filter_module/


substitutions 经测试支持中文替换。