nginx的with-http_sub_module模塊使用之替換字符串

1、介紹

該ngx_http_sub_module模塊是一個過濾器，經過將一個指定的字符串替換爲另外一個字符串來修改響應。該模塊不是默認生成的，它應該使用--with-http_sub_module 配置參數啓用 。

2、指令介紹

2.一、sub_filter指令

做用：用於替換字符串

用法：sub_filter   要替換的字符串   替換後的字符串，不區分字符串的大小寫

範圍：http   server   location

默認：-

2.二、sub_filter_last_modified指令

做用：容許在替換期間保留來自原始響應的「Last-Modified」標題字段以促進響應緩存。默認狀況下，在處理期間修改響應的內容時，標題字段被刪除。

用法：sub_filter_last_modified  on | off

範圍：http   server   location

默認：sub_filter_last_modified  on

 2.三、sub_filter_once

做用：指示是否查找每一個字符串以替換一次或重複替換。

用法：sub_filter_once  on | off

範圍：http   server   location

默認：http   server   location

2.四、sub_filter_types

做用：指定MIME類型的字符串替換，除了「 text/html」 以外，還能夠在指定MIME類型的響應中啓用字符串替換。特殊值「 *」匹配任何MIME類型

用法：sub_filter_types mime-type ...

範圍：http   server   location

默認：sub_filter_types text / html;

3、操做演示

3.一、編譯安裝nginx

編譯安裝nginx,注意加上--with-http_sub_module模塊，這裏提供編譯的參數：

./configure \
--prefix=/usr \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--pid-path=/var/run/nginx/nginx.pid \
--with-http_ssl_module \
--with-http_flv_module \
--with-http_stub_status_module \
--with-http_gzip_static_module \
--http-log-path=/var/log/nginx/access.log \
--http-client-body-temp-path=/var/tmp/nginx/client \
--http-proxy-temp-path=/var/tmp/nginx/proxy \
--http-fastcgi-temp-path=/var/tmp/nginx/fcgi \
--with-http_stub_status_module \
--with-http_sub_module \

 

3.二、安裝nginx

make && make  install

 

3.3修改配置文件nginx.conf

 location / {
           sub_filter 'nginx.com' 'baidu.com'; --把nginx.com替換成了baidu.com
           sub_filter 'nginx.org' 'buy.jiegeng.com';--把ngin.org替換成了buy.jiegeng.com
           sub_filter_types css/html;--替換的類型 sub_filter_once off;--所有替換
           root  html;
           index  index.html index.htm;
        }

3.四、重啓

/usr/sbin/nginx    -s   reload

3.五、驗證

3.5.1修改後頁面

 

3.5.2原始頁面

 4、支持正則的第三方模塊

使用ngx_http_sub_module模塊好處是nginx內置該模塊使用方便，不足之處在於該模塊不支持正則替換，靈活性不夠，

支持正則匹配替換的第三方模塊ngx_http_substitutions_filter_module：

4.一、下載

下載地址：https://github.com/yaoweibin/ngx_http_substitutions_filter_module/archive/master.zip

 添加參數--add-module=/模塊解壓後文件路徑

./configure \
--prefix=/usr \
--sbin-path=/usr/sbin/nginx \
--conf-path=/etc/nginx/nginx.conf \
--error-log-path=/var/log/nginx/error.log \
--pid-path=/var/run/nginx/nginx.pid \
--with-http_ssl_module \
--with-http_flv_module \
--with-http_stub_status_module \
--with-http_gzip_static_module \
--http-log-path=/var/log/nginx/access.log \
--http-client-body-temp-path=/var/tmp/nginx/client \
--http-proxy-temp-path=/var/tmp/nginx/proxy \
--http-fastcgi-temp-path=/var/tmp/nginx/fcgi \
--with-http_stub_status_module \
--with-http_sub_module \
--add-module=../ngx_http_substitutions_filter_module-master

4.二、subs_filter的使用介紹

* subs_filter
subs_filter 語法： subs_filter source_str destination_str [gior]
默認： none
適用： http，server，location
subs_filter 是用來替換文本的，可使用正則
g（默認）：替換匹配項。
i  ：區分大小寫的匹配
o : 只匹配發現的第一個。
r  : 正則匹配。