Sub#
Фильтр, изменяющий в ответе одну заданную строку на другую.
При сборке из исходного кода модуль не собирается по умолчанию; его необходимо
включить с помощью параметра сборки
‑‑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#
Задает строку, которую нужно заменить, и строку замены. Заменяемая строка проверяется без учета регистра. В заменяемой строке и в строке замены можно использовать переменные. На одном уровне конфигурации может быть указано несколько директив sub_filter. Директивы наследуются с предыдущего уровня конфигурации при условии, что на данном уровне не описаны свои директивы sub_filter.
sub_filter_last_modified#
|
|
По умолчанию |
|
http, server, location |
Позволяет сохранить поле заголовка «Last-Modified» исходного ответа во время замены для лучшего кэширования ответов.
По умолчанию поле заголовка удаляется, так как содержимое ответа изменяется во время обработки.
sub_filter_once#
|
|
По умолчанию |
|
http, server, location |
Определяет, сколько раз нужно искать каждую из заменяемых строк: один раз или многократно.
sub_filter_types#
|
|
По умолчанию |
|
http, server, location |
Разрешает замену строк в ответах с указанными MIME-типами в дополнение к «text/html». Специальное значение «*» соответствует любому MIME-типу.