Redirecionamentos 301 no .htaccess para WordPress: O Guia Técnico

#1. O ciclo de vida do pedido e o bloco nativo do WordPress

Quando instala o WordPress e ativa a estrutura de ligações permanentes (Pretty Permalinks), o núcleo gera um bloco padrão no ficheiro .htaccess:

# BEGIN WordPress
# The directives (lines) between "BEGIN WordPress" and "END WordPress" are
# dynamically generated, and should only be modified via WordPress filters.
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress

#O erro clássico de posicionamento

Se adicionar as suas regras personalizadas no final do ficheiro, após a linha # END WordPress, elas nunca serão executadas para páginas apagadas ou movidas.

A linha RewriteRule . /index.php [L] contém a flag [L] (Last). Quando um pedido para um endereço inexistente atinge esta instrução, o Apache entrega imediatamente o controlo ao script index.php do WordPress e cessa qualquer processamento adicional do ficheiro. O WordPress assume então o pedido e gera uma página de erro 404, sem nunca consultar as regras situadas abaixo.

Regra mandatória: Qualquer regra de redirecionamento 301, reencaminhamento de domínio ou normalização canónica deve ser inserida estritamente antes do comentário # BEGIN WordPress.

Além disso, sempre que altera as definições de ligações permanentes no painel de administração, o WordPress reescreve por completo o conteúdo situado entre # BEGIN WordPress e # END WordPress, apagando qualquer instrução que tenha sido colocada inadvertidamente no interior desse espaço.

#2. Incompatibilidades entre mod_alias e mod_rewrite

O Apache dispõe de dois módulos para manipular caminhos de rede:

• mod_alias: Controla as diretivas Redirect e RedirectMatch. É direto e eficiente para correspondências estáticas, mas atua em bloco e não tem acesso a variáveis avançadas do servidor nem a cadeias de consulta (query strings).
• mod_rewrite: O motor completo de reescrita com suporte para expressões regulares, condições lógicas (RewriteCond) e flags de controlo de fluxo.

#O conflito de fases no Apache

O motor do Apache divide a resolução de cada pedido em fases internas de execução. O módulo mod_rewrite é invocado antes do mod_alias, qualquer que seja a ordem visual das linhas no ficheiro .htaccess.

Considere o seguinte exemplo:

# Exemplo incorreto:
Redirect 301 /servico-antigo/ /servico-novo/
RewriteRule ^servico-antigo/(.*)$ /catalogo/$1 [R=301,L]

O Apache processará primeiro a diretiva RewriteRule. Dependendo da estrutura dos ficheiros em disco, o pedido pode resultar numa concatenação corrompida de destinos ou num ciclo fechado de redirecionamentos.

Boa prática de engenharia: Em projetos WordPress com o motor de reescrita ativo, utilize exclusivamente diretivas RewriteRule para todos os redirecionamentos, assegurando coerência absoluta no processamento.

#3. Redirecionamento 1:1 para páginas movidas

Para páginas individuais que mudaram de endereço de forma permanente, deve isolar o início (^) e o fim ($) do caminho relativo com expressões regulares:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /

# Redirecionar página única mantendo compatibilidade com barra final
RewriteRule ^sobre-nos/?$ /empresa/ [R=301,L]

# Redirecionar ficheiro com extensão legada para URL limpo
RewriteRule ^artigo-tecnico\.html$ /artigo-tecnico/ [R=301,L]
</IfModule>

A inclusão do padrão /? torna a regra insensível à presença ou ausência da barra final no pedido do utilizador. A flag [R=301] instrui o servidor a emitir o código de estado HTTP 301 Moved Permanently, transferindo o sinal de autoridade nos motores de busca.

#4. Normalização canónica: HTTPS e domínio com ou sem WWW

Um dos problemas mais comuns detetados em auditorias técnicas é a existência de cadeias com múltiplos redirecionamentos 301 sucessivos. Por exemplo:

1. http://dominio.pt reencaminha para https://dominio.pt
2. https://dominio.pt reencaminha para https://www.dominio.pt

Cada salto adicional consome tempo de resposta (TTFB) na rede móvel e desgasta o orçamento de rastreio (crawl budget) dos motores de busca. Deve consolidar as duas verificações numa única avaliação lógica:

#Opção A: Forçar HTTPS e prefixo WWW em simultâneo

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /

# Se não estiver em HTTPS OU se o domínio não começar por www
RewriteCond %{HTTPS} !=on [OR]
RewriteCond %{HTTP_HOST} !^www\. [NC]
RewriteCond %{HTTP_HOST} ^(?:www\.)?(.+)$ [NC]
RewriteRule ^(.*)$ https://www.%1/$1 [R=301,L]
</IfModule>

#Opção B: Forçar HTTPS e domínio sem WWW (naked domain)

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /

# Se não estiver em HTTPS OU se o domínio contiver o prefixo www
RewriteCond %{HTTPS} !=on [OR]
RewriteCond %{HTTP_HOST} ^www\.(.+)$ [NC]
RewriteCond %{HTTP_HOST} ^(?:www\.)?(.+)$ [NC]
RewriteRule ^(.*)$ https://%1/$1 [R=301,L]
</IfModule>

Em qualquer dos cenários, qualquer combinação de protocolo inseguro ou formato de anfitrião é resolvida num único salto direto para o endereço canónico final.

#5. Gestão de parâmetros de URL (Query Strings)

A diretiva padrão RewriteRule avalia apenas o caminho textual do pedido (Request Path), ignorando os argumentos presentes após o ponto de interrogação (?).

Isto significa que a regra seguinte não funcionará:

# REGRA INEFICAZ:
RewriteRule ^detalhe\.php\?produto_id=40$ /novo-produto/ [R=301,L]

Para capturar e redirecionar endereços antigos que dependiam de parâmetros GET (típicos de plataformas legadas), é obrigatório recorrer à variável %{QUERY_STRING} através de RewriteCond:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /

# Redirecionar URL antigo com parâmetro específico e descartar a query string
RewriteCond %{QUERY_STRING} (^|&)produto_id=40(&|$)
RewriteRule ^detalhe\.php$ /novo-produto/ [QSD,R=301,L]
</IfModule>

#A importância da flag QSD (Query String Discard)

No Apache 2.4, a inclusão da flag QSD garante que os parâmetros antigos são eliminados no destino. Sem esta flag, o Apache preserva a cadeia original e produz o endereço indesejado /novo-produto/?produto_id=40.

Caso pretenda preservar parâmetros legítimos de campanha ou paginação, utilize a flag QSA (Query String Append):

# Preservar parâmetros UTM ou filtros na mudança de taxonomia
RewriteRule ^antiga-categoria/(.*)$ /nova-categoria/$1 [QSA,R=301,L]

#6. Redirecionamento integral de domínio

Quando duas marcas se fundem ou um projeto transita para um novo domínio com preservação da estrutura interna de páginas, implementa-se o reencaminhamento global:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /

# Encaminhar todo o tráfego de dominio-antigo.pt para dominio-novo.pt
RewriteCond %{HTTP_HOST} ^(?:www\.)?dominio-antigo\.pt$ [NC]
RewriteRule ^(.*)$ https://dominio-novo.pt/$1 [R=301,L]
</IfModule>

A variável $1 armazena a totalidade do caminho relativo após a barra inicial, mantendo intactas as referências a artigos, imagens e documentos.

#7. Impacto no desempenho: quando migrar para além do .htaccess

Embora o ficheiro .htaccess ofereça flexibilidade durante o desenvolvimento local, o seu funcionamento em produção acarreta um custo computacional contínuo:

1. A cada pedido de imagem, ficheiro de estilos ou fonte tipográfica, o servidor tem de verificar o sistema de ficheiros em busca de ficheiros .htaccess em todas as diretorias parentes.
2. Ficheiros com centenas ou milhares de linhas de regras têm de ser analisados e compilados repetidamente, degradando a latência do servidor (Time to First Byte).

#Estratégias para grandes volumes de redirecionamentos:

• Configuração no VirtualHost: Se dispõe de acesso ao ficheiro de configuração do Apache (httpd.conf ou ficheiros em sites-available), transfira as listas volumosas para o bloco do anfitrião virtual. O Apache compila essas diretivas no arranque para memória RAM, eliminando o custo de disco por pedido.
• Mapeamento em Nginx: Em arquiteturas com Nginx como proxy inverso diante do Apache, estruture as listas através de blocos map, que operam com uma tabela de dispersão (hash table) com tempo de pesquisa constante O(1).
• Redirecionamentos na CDN (Edge Redirects): Para sítios de comércio eletrónico de grande escala com milhares de URLs descontinuados, descarregue essa responsabilidade para a Cloudflare (Bulk Redirects). O pedido é respondido na borda da rede em poucos milissegundos, poupando totalmente os recursos do servidor de origem.

#Procedimento de teste e validação

Antes de disponibilizar novas regras em ambiente de produção, cumpra as seguintes etapas de segurança:

1. Confirme que todas as instruções residem antes da linha # BEGIN WordPress.
2. Verifique a sintaxe com a ferramenta de linha de comandos: curl -ILs "https://dominio.pt/url-antigo/" | grep -E "HTTP|Location".
3. Teste em navegadores anónimos ou com as ferramentas de desenvolvimento abertas com a opção Disable cache ativa, para não sofrer a interferência de respostas 301 gravadas localmente.

Se necessita de apoio profissional na orquestração de migrações complexas de catálogos WooCommerce ou otimização profunda de infraestrutura, conheça o nosso trabalho de consultoria e engenharia WordPress.