FAQ

Page Discussion History

Difference between revisions of "HttpSubModule"

(Directives)
(One intermediate revision by one user not shown)
Line 1: Line 1:
 +
<span style="color:red">WARNING: this article is obsoleted. Please refer to http://nginx.org/en/docs/ for the latest official documentation.</span>
 +
 
= Synopsis =
 
= Synopsis =
  
Line 16: Line 18:
 
= Directives =
 
= Directives =
 
== sub_filter ==
 
== sub_filter ==
<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_sub_module/sub_filter.txt" />
+
<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_sub_module/sub_filter.txt" />
  
 
''sub_filter'' allows replacing some text in the nginx response with some other text, independently of the source of the data. The matching is case-insensitive. Substitution text may contain variables. Only one substitution rule per location is supported.
 
''sub_filter'' allows replacing some text in the nginx response with some other text, independently of the source of the data. The matching is case-insensitive. Substitution text may contain variables. Only one substitution rule per location is supported.
  
 
== sub_filter_once ==
 
== sub_filter_once ==
<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_sub_module/sub_filter_once.txt" />
+
<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_sub_module/sub_filter_once.txt" />
  
 
''sub_filter_once off'' allows to search and replace all matching lines, the default is replacing only the first one.
 
''sub_filter_once off'' allows to search and replace all matching lines, the default is replacing only the first one.
  
 
== sub_filter_types ==
 
== sub_filter_types ==
<include wikitext nopre src="http://wiki.nginx.org/nginx.org/ngx_http_sub_module/sub_filter_types.txt" />
+
<include wikitext nopre src="http://wiki.nginx.org/nginx.org/http/ngx_http_sub_module/sub_filter_types.txt" />
  
 
''sub_filter_types'' is used to specify which content types should be checked for ''sub_filter''.  The default is only ''text/html''.
 
''sub_filter_types'' is used to specify which content types should be checked for ''sub_filter''.  The default is only ''text/html''.

Revision as of 08:05, 23 August 2013

WARNING: this article is obsoleted. Please refer to http://nginx.org/en/docs/ for the latest official documentation.

Contents

Synopsis

This module can search and replace text in the nginx response. It is only available if the

--with-http_sub_module option

was specified for ./configure.

Example:

location / {
  sub_filter      </head>
  '</head><script language="javascript" src="$script"></script>';
  sub_filter_once on;
}

Directives

sub_filter

Syntax: sub_filter string replacement
Default:
Context: http
server
location
Reference:sub_filter


sub_filter allows replacing some text in the nginx response with some other text, independently of the source of the data. The matching is case-insensitive. Substitution text may contain variables. Only one substitution rule per location is supported.

sub_filter_once

Syntax: sub_filter_once on | off
Default: on
Context: http
server
location
Reference:sub_filter_once


sub_filter_once off allows to search and replace all matching lines, the default is replacing only the first one.

sub_filter_types

Syntax: sub_filter_types mime-type ...
Default: text/html
Context: http
server
location
Reference:sub_filter_types


sub_filter_types is used to specify which content types should be checked for sub_filter. The default is only text/html.

References

Original Documentation