<!-- review: finished -->

<a id="http-sub"></a>

# 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](https://es.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild), este módulo no se compila por defecto; debe habilitarse con la `‑‑with‑http_sub_module` [opción de compilación](https://es.angie.software//angie/docs/installation/sourcebuild.md#configure).

En paquetes e imágenes de [nuestros repositorios](https://es.angie.software//angie/docs/installation/index.md#install-packages), el módulo está incluido en la compilación.

<a id="configuration-example-44"></a>

## Ejemplo de configuración

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

<a id="directives-47"></a>

## Directivas

<a id="index-0"></a>

<a id="sub-filter"></a>

### sub_filter

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `sub_filter` cadena reemplazo;   |
|--------------------------------------------------------------------------------------------|----------------------------------|
| Predeterminado                                                                             | —                                |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | 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.

<a id="index-1"></a>

<a id="sub-filter-last-modified"></a>

### sub_filter_last_modified

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `sub_filter_last_modified` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|--------------------------------------------|
| Predeterminado                                                                             | `sub_filter_last_modified off;`            |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | 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.

<a id="index-2"></a>

<a id="sub-filter-once"></a>

### sub_filter_once

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `sub_filter_once` `on` | `off`;   |
|--------------------------------------------------------------------------------------------|-----------------------------------|
| Predeterminado                                                                             | `sub_filter_once on;`             |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | http, server, location            |

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

<a id="index-3"></a>

<a id="sub-filter-types"></a>

### sub_filter_types

| [Sintaxis](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | `sub_filter_types` mime-tipo ...;   |
|--------------------------------------------------------------------------------------------|-------------------------------------|
| Predeterminado                                                                             | `sub_filter_types text/html;`       |
| [Contexto](https://es.angie.software//angie/docs/configuration/configfile.md#configfile)   | 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.
