Como Usar Regex em Blocos Location do Nginx?

Sintaxe para Usar Regex em Blocos Location

A estrutura básica de um bloco location com regex no Nginx segue este padrão:

location ~ regex_pattern {
    # Diretivas de configuração
}

O modificador til (~) mostra que o bloco location usa uma expressão regular sensível a maiúsculas e minúsculas. Para correspondência insensível a maiúsculas e minúsculas, use o modificador til-asterisco (~*):

location ~* regex_pattern {
    # Diretivas de configuração
}

Padrões Regex Comuns para Blocos Location do Nginx

Corresponder extensões de arquivo é um uso comum para regex em blocos location do Nginx. Por exemplo, para corresponder todos os arquivos PHP:

location ~ \.php$ {
    # Diretivas de manipulação de arquivos PHP
}

Grupos de captura permitem extrair partes da URL correspondente para uso na sua configuração. Aqui está um exemplo que captura um nome de usuário de uma URL:

location ~ ^/user/([^/]+) {
    set $username $1;
    # Use $username na sua configuração
}

Alternância permite que você corresponda múltiplos padrões em um único bloco location. Este exemplo corresponde páginas "about" ou "contact":

location ~ ^/(about|contact)$ {
    # Diretivas para páginas about ou contact
}

Esses padrões mostram como regex pode criar correspondência flexível de URL em blocos location do Nginx.

location = /favicon.ico {
    log_not_found off;
    access_log off;
}

Correspondência Sensível vs Insensível a Maiúsculas e Minúsculas

O Nginx oferece opções para correspondência sensível e insensível a maiúsculas e minúsculas em blocos location usando expressões regulares.

Usando ~ para correspondência sensível a maiúsculas e minúsculas:

location ~ ^/About$ {
    # Isso corresponderá a /About mas não a /about
}

Usando ~* para correspondência insensível a maiúsculas e minúsculas:

location ~* ^/about$ {
    # Isso corresponderá a /about, /About, /ABOUT, etc.
}

Correspondência sensível a maiúsculas e minúsculas é útil quando você precisa distinguir entre URLs em maiúsculas e minúsculas. Correspondência insensível a maiúsculas e minúsculas ajuda quando você quer tratar variações da mesma palavra igualmente.

location ~ ^/API/ {
    # Correspondência sensível a maiúsculas e minúsculas para endpoints de API
}

location ~* \.(jpg|jpeg|png|gif)$ {
    # Correspondência insensível a maiúsculas e minúsculas para arquivos de imagem
}

Negando Padrões Regex em Blocos Location

Você pode usar lookaheads negativos para excluir padrões específicos de correspondência em blocos location do Nginx.

Implementando lookaheads negativos:

location ~ ^/(?!admin|private).*$ {
    # Isso corresponderá a todas as URLs exceto aquelas que começam com /admin ou /private
}

Excluindo padrões específicos de correspondência:

location ~ ^/files/(?!restricted/).*$ {
    # Isso corresponderá a todos os arquivos exceto aqueles no diretório 'restricted'
}

Essas técnicas permitem que você crie regras de correspondência mais complexas, dando mais controle sobre como o Nginx lida com diferentes padrões de URL.

Melhores Práticas para Regex no Nginx

Padrões regex simples e eficientes ajudam a manter um servidor Nginx com bom desempenho. Aqui estão algumas dicas:

1. Use âncoras (^ e $) para corresponder ao início e fim da string. Isso impede correspondências parciais.

2. Agrupe padrões relacionados usando parênteses () para melhorar a legibilidade e o desempenho.

3. Use grupos não-capturadores (?:) quando você não precisar referenciar o conteúdo correspondente posteriormente.

4. Use quantificadores ({n}, {n,m}) em vez de repetir padrões quando possível.

location ~* \.(jpg|jpeg|png|gif)$ {
    # Diretivas para arquivos de imagem
}

Evite regex para correspondências exatas. Para URLs estáticas ou caminhos de arquivo, use o modificador de correspondência exata (=):

location = /exact/path {
    # Diretivas
}

Isso é mais rápido que correspondência regex e pode melhorar o desempenho do servidor.

Solucionando Problemas de Regex em Blocos Location do Nginx

Erros comuns de regex na configuração do Nginx incluem:

1. Não escapar caracteres especiais como . e ?, que têm significados especiais em regex.

2. Usar grupos de captura (() quando grupos não-capturadores (?:) funcionariam.

3. Escrever padrões complexos que são difíceis de manter e podem diminuir o processamento.

4. Não considerar todas as variações possíveis de entrada, levando a correspondências erradas.

Ferramentas para testar e depurar padrões regex:

1. Testadores de regex online como regex101.com ou regexr.com podem ajudar você a testar seus padrões.

2. O log de erros do Nginx pode fornecer informações sobre problemas relacionados a regex. Aumente o nível de log para mais detalhes:

error_log /var/log/nginx/error.log debug;

3. Use o comando nginx -t para testar seu arquivo de configuração em busca de erros de sintaxe antes de recarregar o servidor.

4. O utilitário pcretest permite que você teste padrões regex PCRE a partir da linha de comando.

Seguindo essas práticas e usando essas ferramentas, você pode criar melhores padrões regex em seus blocos location do Nginx.