Модуль ngx_http_sub_module
Модуль 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 string replacement; |
|---|---|
| Значение по умолчанию: | — |
| Контекст: | http, server, location |
Устанавливает строку для замены и строку замены. Строка для замены сравнивается без учёта регистра. Строка для замены (1.9.4) и строка замены могут содержать переменные. Несколько директивы sub_filter могут быть указаны на одном уровне конфигурации (1.9.4). Эти директивы наследуются с предыдущего уровня конфигурации только в том случае, если на текущем уровне не определены директивы sub_filter.
| Синтаксис: | 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-type ...; |
|---|---|
| Значение по умолчанию: | sub_filter_types text/html; |
| Контекст: | http, server, location |
Включает замену строк в ответах со значениями MIME-типов, указанными в дополнение к «text/html». Специальное значение «*» соответствует любому MIME-типу (0.8.29).
© 2002-2021 Igor Sysoev
© 2011-2024 Nginx, Inc.
Licensed under the BSD License.
https://nginx.org/en/docs/http/ngx_http_sub_module.html