Sub#
The module is a filter that modifies a response by replacing one specified string by another.
When building from the source code,
this module isn’t built by default;
it should be enabled with the
‑‑with‑http_sub_module
build option.
In packages and images from our repos, the module is included in the build.
Configuration Example#
location / {
sub_filter '<a href="http://127.0.0.1:8080/' '<a href="https://$host/';
sub_filter '<img src="http://127.0.0.1:8080/' '<img src="https://$host/';
sub_filter_once on;
}
Directives#
sub_filter#
Sets a string to replace and a replacement string. The string to replace is matched ignoring the case. The string to replace and replacement string can contain variables. Several sub_filter directives can be specified on the same configuration level. These directives are inherited from the previous configuration level if and only if there are no sub_filter directives defined on the current level.
sub_filter_last_modified#
|
|
Default |
|
http, server, location |
Allows preserving the “Last-Modified” header field from the original response during replacement to facilitate response caching.
By default, the header field is removed as contents of the response are modified during processing.
sub_filter_once#
Indicates whether to look for each string to replace once or repeatedly.
sub_filter_types#
|
|
Default |
|
http, server, location |
Enables string replacement in responses with the specified MIME types in addition to “text/html”. The special value “*” matches any MIME type.