Модуль http_sub

Фильтр, изменяющий в ответе одну заданную строку на другую.

Пример конфигурации

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-типу.