# Sub O módulo é um filtro que modifica uma resposta substituindo uma string especificada por outra. Ao [compilar a partir do código-fonte](https://pt.angie.software//angie/docs/installation/sourcebuild.md#sourcebuild), este módulo não é compilado por padrão; ele deve ser habilitado com a `‑‑with‑http_sub_module` [opção de compilação](https://pt.angie.software//angie/docs/installation/sourcebuild.md#configure). Em pacotes e imagens dos [nossos repositórios](https://pt.angie.software//angie/docs/installation/index.md#install-packages), o módulo está incluído na compilação. ## Exemplo de Configuração ```nginx location / { sub_filter ' ## Diretivas ### sub_filter | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `sub_filter` string replacement; | |-------------------------------------------------------------------------------------------|------------------------------------| | Padrão | — | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Define uma string a ser substituída e uma string de substituição. A string a ser substituída é correspondida ignorando maiúsculas e minúsculas. A string a ser substituída e a string de substituição podem conter variáveis. Várias diretivas `sub_filter` podem ser especificadas no mesmo nível de configuração. Essas diretivas são herdadas do nível de configuração anterior se e somente se não houver diretivas `sub_filter` definidas no nível atual. ### sub_filter_last_modified | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `sub_filter_last_modified` `on` | `off`; | |-------------------------------------------------------------------------------------------|--------------------------------------------| | Padrão | `sub_filter_last_modified off;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Permite preservar o campo de cabeçalho `Last-Modified` da resposta original durante a substituição para facilitar o cache da resposta. Por padrão, o campo de cabeçalho é removido, pois o conteúdo da resposta é modificado durante o processamento. ### sub_filter_once | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `sub_filter_once` `on` | `off`; | |-------------------------------------------------------------------------------------------|-----------------------------------| | Padrão | `sub_filter_once on;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Indica se deve procurar por cada string a ser substituída uma vez ou repetidamente. ### sub_filter_types | [Sintaxe](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | `sub_filter_types` mime-type ...; | |-------------------------------------------------------------------------------------------|-------------------------------------| | Padrão | `sub_filter_types text/html;` | | [Contexto](https://pt.angie.software//angie/docs/configuration/configfile.md#configfile) | http, server, location | Habilita a substituição de strings em respostas com os tipos MIME especificados além de `text/html`. O valor especial "\*" corresponde a qualquer tipo MIME.