Spec-Zone.ru › nginx

Модуль ngx_http_sub_module

  • Пример конфигурации
  • Директивы
  • sub_filter
  • sub_filter_last_modified
  • sub_filter_once
  • sub_filter_types

Модуль 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

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API