Модуль http_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-типу.