Sub#

O módulo é um filtro que modifica uma resposta substituindo uma string especificada por outra.

Ao compilar a partir do código-fonte, este módulo não é compilado por padrão; ele deve ser habilitado com a ‑‑with‑http_sub_module opção de compilação.

Em pacotes e imagens dos nossos repositórios, o módulo está incluído na compilação.

Exemplo de Configuração#

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

Diretivas#

sub_filter#

Sintaxe

sub_filter string replacement;

Padrão

—

Contexto

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

sub_filter_last_modified on | off;

Padrão

sub_filter_last_modified off;

Contexto

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

sub_filter_once on | off;

Padrão

sub_filter_once on;

Contexto

http, server, location

Indica se deve procurar por cada string a ser substituída uma vez ou repetidamente.

sub_filter_types#

Sintaxe

sub_filter_types mime-type ...;

Padrão

sub_filter_types text/html;

Contexto

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.