nginx使用replace-filter-nginx-module实现内容替换的示例

有时候我们想对响应（例如PHP接口）返回的内容做些字符串，虽然可以使用各语言代码相关方法（例如PHP的str_replace）进行替换，但是在nginx层面替换是更方便的，无需修改代码。

约定：本文源代码目录统一放在：/root/soft/src 里。

安装

安装此模块需要先安装 sregex 运行库：

$ git clone https://github.com/agentzh/sregex$ cd sregex$ make$ make install

然后安装 replace-filter-nginx-module 模块：

$ cd /root/soft/src$ git clone https://github.com/agentzh/replace-filter-nginx-module$ wget http://nginx.org/download/nginx-1.12.2.tar.gz$ tar zxvf nginx-1.12.2.tar.gz

这里采用静态编译的方式安装模块，需要重新编译 nginx 。获取 nginx 上一次编译参数：

$ nginx -Vnginx version: nginx/1.12.2built by gcc 4.4.7 20120313 (Red Hat 4.4.7-16) (GCC) built with OpenSSL 1.0.1e-fips 11 Feb 2013TLS SNI support enabledconfigure arguments: --user=www --group=www --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module --with-http_gzip_static_module --with-ipv6 --with-http_sub_module --with-ld-opt=-ljemalloc --with-http_ssl_module --with-http_realip_module --with-http_addition_module --with-http_sub_module 

这里添加 replace-filter-nginx-module 模块：

--add-module=/root/soft/src/replace-filter-nginx-module

最终编译命令：

cd nginx-1.12.2$ ./configure --user=www --group=www --prefix=/usr/local/nginx --with-http_stub_status_module --with-http_ssl_module --with-http_gzip_static_module --with-ipv6 --with-http_sub_module --with-ld-opt=-ljemalloc --with-http_ssl_module --with-http_realip_module --with-http_addition_module --with-http_sub_module --add-module=/root/soft/src/replace-filter-nginx-module $ make

由于这里是升级nginx，所以千万不要make install，不然就真的覆盖了。 接下来手动替换二进制文件：

$ cp /usr/local/nginx/sbin/nginx /usr/local/nginx/sbin/nginx.bak$ cp -rfp ./objs/nginx /usr/local/nginx/sbin/

测试是否可行：

$ nginx -vnginx version: nginx/1.12.2

配置是否正常：

$ /usr/local/nginx/sbin/nginx -tnginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is oknginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful

配置

这里测试的是：把接口返回的 img.test.com 换成 media.test.com。

修改： /usr/local/nginx/conf/vhost/test.com.conf

location ~ [^/]/.php(/|$){  # comment try_files $uri =404; to enable pathinfo  try_files $uri =404;  fastcgi_pass 127.0.0.1:9000;  fastcgi_index index.php;  include fastcgi.conf;}

为：

location ~ [^/]/.php(/|$){  replace_filter 'img.test.com' 'media.test.com' g;  replace_filter_types application/json;    # comment try_files $uri =404; to enable pathinfo  try_files $uri =404;  fastcgi_pass 127.0.0.1:9000;  fastcgi_index index.php;  include fastcgi.conf;