Модуль ngx_http_sub_module — это фильтр,
изменяющий в ответе одну заданную строку на другую.
По умолчанию этот модуль не собирается, его сборку необходимо
разрешить с помощью конфигурационного параметра
--with-http_sub_module .
Пример конфигурации
location / {
sub_filter </head>
'</head><script language="javascript" src="$script"></script>';
sub_filter_once on;
}
Директивы
синтаксис:
|
sub_filter строка замена ;
|
умолчание:
|
—
|
контекст:
|
http , server , location
|
Задаёт строку, которую нужно заменить, и строку замены.
Заменяемая строка проверяется без учёта регистра.
В строке замены можно использовать переменные.
синтаксис:
|
sub_filter_last_modified on | off ;
|
умолчание:
|
sub_filter_last_modified off;
|
контекст:
|
http , server , location
|
Эта директива появилась в версии 1.5.1.
Позволяет сохранить поле заголовка “Last-Modified”
исходного ответа во время замены
для лучшего кэширования ответов.
По умолчанию поле заголовка удаляется, так как содержимое ответа
изменяется во время обработки.
синтаксис:
|
sub_filter_once on | off ;
|
умолчание:
|
sub_filter_once on;
|
контекст:
|
http , server , location
|
Определяет, сколько раз нужно искать заменяемую строку: один
раз или несколько раз.
синтаксис:
|
sub_filter_types mime-тип ...;
|
умолчание:
|
sub_filter_types text/html;
|
контекст:
|
http , server , location
|
Разрешает замену строк в ответах с указанными MIME-типами
в дополнение к “text/html ”.
Специальное значение “* ” соответствует любому MIME-типу
(0.8.29).
|