Exemplos de regex de localização Nginx

A diretiva Nginx Location permite o roteamento de solicitações para um local específico no sistema de arquivos. Enquanto o Nginx está comparando ou pesquisando um bloco de localização com a URL solicitada, a diretiva de localização informa ao Nginx onde pesquisar um caminho específico, incluindo todos os arquivos e diretórios.

Explicaremos os exemplos de regex de localização do Nginx em breves detalhes neste artigo.

Pré-requisitos

Presume-se neste artigo que o Nginx já está instalado em seu sistema.

Sintaxe da diretiva de localização Nginx

A seguinte sintaxe está disponível para o diretório de localização no arquivo de configuração Nginx:

localização [modificador] [correspondência de URL]
…

O bloco de localização Nginx pode ser adicionado em um bloco de servidor ou em outro local com algumas condições predefinidas. Na sintaxe acima, o modificador é um parâmetro opcional. A presença de modificadores no bloco de localização permite ao Nginx lidar com um URL em uma ordem diferente. Aqui, alguns modificadores são mencionados abaixo com alguns exemplos:

1. Combinando todas as solicitações com o bloco de localização Nginx

O '/' é usado para a localização do prefixo para corresponder a todos os pedidos. No entanto, se nenhuma das melhores correspondências for pesquisada, ela será usada como o último resultado.

Exemplo
No seguinte bloco de localização, ele corresponderá a todas as solicitações:

localização /

2. Corresponder ao diretório usando o bloco de localização no Nginx

O exemplo a seguir corresponderá a qualquer solicitação no bloco de localização que comece com / images /. Consequentemente, procurar um bloco correspondente mais específico em relação ao URI solicitado. No entanto, se o Nginx não procurar uma correspondência mais específica, o bloco de localização será selecionado diretamente.

Exemplo
No exemplo a seguir, o Nginx corresponderá a qualquer solicitação no bloco de localização que comece com / images /.

localização / imagens /

3. Faça a correspondência exata usando o modificador de localização '=' (igual a)

O modificador '=' sinal de igual é usado quando você combina exatamente o bloco de localização com um URI solicitado.

Exemplo
O Nginx primeiro tenta combinar os locais de prefixo mais específicos. No entanto, no exemplo a seguir, o modificador '=' no bloco de localização corresponderá exatamente ao caminho do prefixo solicitado e, em seguida, parará de procurar por melhores correspondências.

localização = / imgs
…

No exemplo de bloco de localização mencionado acima, o modificador de localização '=' corresponderá exatamente ao URL mydomain.com / imgs. Os URLs mydomain / imgs / index.html 'ou' mydomain / imgs / 'não corresponderá à condição.

4. Correspondência de Regex sensível a maiúsculas e minúsculas usando o modificador Tilda (~)

O modificador tilda (~) executa a pesquisa de correspondência de expressão regular com distinção entre maiúsculas e minúsculas no URI solicitado e procura continuamente por uma correspondência melhor.

Exemplo
O modificador ~ no exemplo a seguir executa a correspondência regex (expressão regular) com distinção entre maiúsculas e minúsculas no bloco de localização:

localização ~ / imgs
…

5. Correspondência sem distinção entre maiúsculas e minúsculas usando o modificador tilda (~ *)

O sinal de til com um modificador de asterisco (~ *) corresponde a qualquer solicitação (não diferencia maiúsculas de minúsculas) no próximo bloco de localização que termina com um formato de arquivo específico, como arquivo terminando com png, gif, ico, jpeg, jpg, css ou js. No entanto, todas as solicitações enviadas para a pasta / imgs / serão atendidas pelo bloco de localização anterior.

Exemplo
No bloco de localização a seguir, ele corresponderá a todos os tipos de arquivo que não diferenciam maiúsculas de minúsculas.

localização ~ * .(png | ico | gif | jpg | jpeg | css | js) $
…

6. Modificador de sinal acento circunflexo (^ ~) para correspondência RegEx

O modificador caret-tilda (^ ~) é usado para realizar a correspondência da expressão regular com distinção entre maiúsculas e minúsculas no URL solicitado. Portanto, se o URI correspondente for correspondido no / imgs ou / imgs / pico.png, ele para de pesquisar para encontrar uma correspondência melhor.

localização ^ ~ / imgs
…

Conclusão

Discutimos alguns exemplos e detalhes importantes sobre a diretiva de localização Nginx com regex. Também mencionamos o uso de modificadores com exemplos neste artigo. Espero que este artigo ajude você a entender o conceito principal dos blocos de localização no NGINX. Obrigado!