Sub

El módulo es un filtro que modifica una respuesta reemplazando una cadena específica por otra.

Al compilar desde el código fuente, este módulo no se compila por defecto; debe habilitarse con la ‑‑with‑http_sub_module opción de compilación.

En paquetes e imágenes de nuestros repositorios, el módulo está incluido en la compilación.

Ejemplo de configuración

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;
}

Directivas

sub_filter

Sintaxis	sub_filter cadena reemplazo;
Predeterminado	—
Contexto	http, server, location

Establece una cadena a reemplazar y una cadena de reemplazo. La cadena a reemplazar se compara sin distinguir entre mayúsculas y minúsculas. La cadena a reemplazar y la cadena de reemplazo pueden contener variables. Se pueden especificar varias directivas sub_filter en el mismo nivel de configuración. Estas directivas se heredan del nivel de configuración anterior si y solo si no hay directivas sub_filter definidas en el nivel actual.

sub_filter_last_modified

Sintaxis	sub_filter_last_modified on | off;
Predeterminado	sub_filter_last_modified off;
Contexto	http, server, location

Permite preservar el campo de cabecera Last-Modified de la respuesta original durante el reemplazo para facilitar el almacenamiento en caché de la respuesta.

Por defecto, el campo de cabecera se elimina ya que el contenido de la respuesta se modifica durante el procesamiento.

sub_filter_once

Sintaxis	sub_filter_once on | off;
Predeterminado	sub_filter_once on;
Contexto	http, server, location

Indica si se debe buscar cada cadena a reemplazar una vez o repetidamente.

sub_filter_types

Sintaxis	sub_filter_types mime-tipo ...;
Predeterminado	sub_filter_types text/html;
Contexto	http, server, location

Habilita el reemplazo de cadenas en respuestas con los tipos MIME especificados además de text/html. El valor especial "*" coincide con cualquier tipo MIME.