共计 2594 个字符，预计需要花费 7 分钟才能阅读完成。
有时候我们想对响应（例如 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 -V
nginx version: nginx/1.12.2
built by gcc 4.4.7 20120313 (Red Hat 4.4.7-16) (GCC)
built with OpenSSL 1.0.1e-fips 11 Feb 2013
TLS SNI support enabled
configure 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 -v
nginx version: nginx/1.12.2
配置是否正常：
$ /usr/local/nginx/sbin/nginx -t
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: 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;
注意需要添加 replace_filter_types。
保存后检查配置是否 ok：
$ /usr/local/nginx/sbin/nginx -t
nginx: the configuration file /usr/local/nginx/conf/nginx.conf syntax is ok
nginx: configuration file /usr/local/nginx/conf/nginx.conf test is successful
然后热重启：
# 升级完成第一次需要重启
$ service nginx restart
# 热重启
$ /usr/local/nginx/sbin/nginx -s reload
参考：
LNMP 平滑升级 Nginx 并安装 ngx_lua 模块教程 https://www.linuxidc.com/Linux/2018-04/152034.htm
