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 строка замена;

По умолчанию

Контекст

http, server, location

Задает строку, которую нужно заменить, и строку замены. Заменяемая строка проверяется без учета регистра. В заменяемой строке и в строке замены можно использовать переменные. На одном уровне конфигурации может быть указано несколько директив sub_filter. Директивы наследуются с предыдущего уровня конфигурации при условии, что на данном уровне не описаны свои директивы sub_filter.

sub_filter_last_modified#

Синтаксис

sub_filter_last_modified on | off;

По умолчанию

sub_filter_last_modified off;

Контекст

http, server, location

Позволяет сохранить поле заголовка «Last-Modified» исходного ответа во время замены для лучшего кэширования ответов.

По умолчанию поле заголовка удаляется, так как содержимое ответа изменяется во время обработки.

sub_filter_once#

Синтаксис

sub_filter_once on | off;

По умолчанию

sub_filter_once on;

Контекст

http, server, location

Определяет, сколько раз нужно искать каждую из заменяемых строк: один раз или многократно.

sub_filter_types#

Синтаксис

sub_filter_types mime-тип …;

По умолчанию

sub_filter_types text/html;

Контекст

http, server, location

Разрешает замену строк в ответах с указанными MIME-типами в дополнение к «text/html». Специальное значение «*» соответствует любому MIME-типу.