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