HttpSubstitution

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

  1. --with-http_sub_module option

was specified for ./configure.

本模块可以在nginx的回应中查找和替换文本.在编译nginx时必需加上—with-http_sub_module option

例如:

  1. location / {
  2. sub_filter </head>
  3. '</head><script language="javascript" src="$script"></script>';
  4. sub_filter_once on;
  5. }

指令

sub_filter

syntax:sub_filter text substitution

default:none

context:http, server, location

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 允许替换源文件里的多个文本(多次替换)匹配是非常快速的。替换必须包含变量,一个location只能一个替换规则.

sub_filter_once

syntax:sub_filter_once on|off

default:sub_filter_once on

context:http, server, location

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

sub_filter_once off 允许查找替换所有匹配行,默认只替换第一个.

sub_filter_types

syntax:sub_filter_types mime-type [mime-type …]

default:sub_filter_types text/html

context:http, server, location

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用于指定替换sub_filter的类型,默认为text/html.

References

Original Documentation