HttpSubstitution

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.

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

例如:

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

指令

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

原文: https://wizardforcel.gitbooks.io/nginx-doc/content/Text/4.10_sub.html