Accept cookies for analytics, social media, and advertising, or learn more and adjust your preferences. These cookies are on by default for visitors outside the UK and EEA. Privacy Notice.
nginx_substitutions_filter - a filter module which can do both regular expression and fixed string substitutions on response bodies. This module is quite different from the NGINX’s native Substitution Module. It scans the output chains buffer and matches string line by line, just like Apache’s mod_substitute.
Note
This module is not distributed with the NGINX source. See the installation instructions.
location / {
subs_filter_types text/html text/css text/xml;
subs_filter st(\d*).example.com $1.example.com ir;
subs_filter a.example.com s.example.com;
}
Syntax: | subs_filter_types mime-type [ mime-types ] |
---|---|
Default: | text/html |
Context: | http, server, location |
subs_filter_types is used to specify which content types should be checked for subs_filter.
This module just works with plain text. If the response is compressed, it can’t uncompress the response and will ignore this response. This module can be compatible with gzip filter module. But it will not work with proxy compressed response. You can disable the compressed response like this:
proxy_set_header Accept-Encoding "";
Syntax: | subs_filter source_str destination_str [gior] |
---|---|
Default: | g |
Context: | http, server, location |
subs_filter allows replacing source string (regular expression or fixed) in the NGINX response with destination string. Substitution text may contain variables. More than one substitution rules per location is supported. The meaning of the third flags are:
g
: Replace all the match strings.i
: Perform a case-insensitive match.o
: Just replace the first one.r
: The pattern is treated as a regular expression, default is fixed string.To install, get the source with subversion:
git clone git://github.com/yaoweibin/ngx_http_substitutions_filter_module.git
and then compile NGINX with the following option:
./configure --add-module=/path/to/module
06/30/2012: Changes with nginx_substitutions_filter 0.6.0
08/11/2010: Changes with nginx_substitutions_filter 0.5.2
04/15/2010: Changes with nginx_substitutions_filter 0.5
12/23/2009: Changes with nginx_substitutions_filter 0.4
02/04/2009: Changes with nginx_substitutions_filter 0.3
Questions/patches may be directed to Weibin Yao, yaoweibin@gmail.com.