blog
Infraestrutura web

mod_rewrite ativo? 3 lugares para conferir e 1 prova

Três checagens que você faz sozinho, mais o teste que prova que a diretiva passou a valer na resposta HTTP do site.

JR · · 8 min de leitura · 2 tabelas · 5 blocos de código

Resposta curta: em três lugares: um arquivo PHP com `apache_get_modules()`, a tela Apache Modules do EasyApache 4 no painel e um bloco `<IfModule !mod_rewrite.c>` no .htaccess que força erro 500 quando o módulo falta. A prova final é um redirecionamento 301 funcionando.

Neste artigo
  1. O que mod_rewrite, mod_headers, mod_expires e mod_deflate fazem no servidor
  2. Ver a lista de modulos carregados com apache_get_modules()
  3. A tela Apache Modules do EasyApache 4, e por que ela nao aparece na sua conta
  4. Forcar o servidor a responder com uma regra-teste no .htaccess
  5. Modulo carregado nao e diretiva valendo: confira na resposta HTTP
  6. O que so a hospedagem pode fazer, e o que mandar no chamado
  7. Erro 500 depois de mexer no .htaccess: a volta em menos de um minuto

Um plugin de cache avisa "mod_deflate não está disponível". Um plugin de SEO diz que "mod_rewrite não foi detectado". O aviso aparece no painel do WordPress e para por aí: ninguém diz onde conferir. Abaixo estão os três lugares onde você olha com os próprios olhos, e depois o teste que prova que a diretiva passou a valer de verdade.

Antes de qualquer coisa: se você vai mexer no .htaccess, faça uma cópia. É o arquivo que mais derruba site com erro 500 em hospedagem compartilhada, e a volta atrás é trivial se existir cópia.

O que mod_rewrite, mod_headers, mod_expires e mod_deflate fazem no servidor

São módulos do Apache, carregados pelo servidor, não pelo WordPress. O PHP não tem como ligá-los. Quando o plugin reclama, ele está dizendo que o servidor web não expôs aquela funcionalidade.

Módulo O que ele habilita Quem costuma pedir
mod_rewrite Reescrita e redirecionamento de URL no .htaccess Permalinks bonitos do WordPress, redirect 301, plugins de SEO
mod_headers Adicionar, alterar e remover cabeçalhos HTTP da resposta Segurança (HSTS, X-Frame-Options), CORS de fontes
mod_expires Gerar Expires e Cache-Control: max-age por tipo de arquivo Plugins de cache e de "leverage browser caching"
mod_deflate Comprimir a resposta com gzip antes de enviar Plugins de performance, nota do PageSpeed

A lista de módulos que o EasyApache 4 pode instalar, com o nome exato de cada um, está na documentação do cPanel sobre Apache Modules. Vale consultá-la quando o nome que o plugin reclama não bate com o nome do pacote.

Ver a lista de modulos carregados com apache_get_modules()

Esse é o mais direto, porque mostra o que o Apache carregou para o seu site, na sua conta, no momento da requisição.

Crie o arquivo de teste em public_html

No Gerenciador de Arquivos do painel, entre em public_html e crie um arquivo com nome difícil de adivinhar, por exemplo checagem-7fa21.php. Conteúdo:

<?php
if (function_exists('apache_get_modules')) {
    echo '<pre>';
    print_r(apache_get_modules());
    echo '</pre>';
} else {
    echo 'apache_get_modules indisponivel neste modo de PHP';
}

Abra https://seudominio.com.br/checagem-7fa21.php. O resultado esperado é uma lista com dezenas de nomes começando em core, http_core, mod_so. Procure na lista por mod_rewrite, mod_headers, mod_expires, mod_deflate.

Por que a funcao some em PHP-FPM e o que fazer entao

A função só existe quando o PHP roda como módulo do Apache. Em PHP-FPM ou CGI, que é o arranjo mais comum hoje, ela não existe, e isso não significa que os módulos estejam ausentes. Nesse caso use phpinfo() e procure a seção do servidor, ou pule direto para o lugar 2 e para o teste prático da seção seguinte.

Apague o arquivo de teste no mesmo dia

Um phpinfo() exposto entrega versão de PHP, caminhos do sistema e extensões carregadas. Apague o arquivo assim que terminar. Não deixe para amanhã.

A tela Apache Modules do EasyApache 4, e por que ela nao aparece na sua conta

Se sua hospedagem é cPanel e você tem acesso de revendedor ou de servidor, o caminho é WHM > Software > EasyApache 4 > Customize > Apache Modules. A tela lista cada módulo com um botão de instalado ou não instalado, e os nomes seguem o padrão ea-apache24-mod_* (por exemplo, ea-apache24-mod_deflate), conforme a documentação de Apache Modules do cPanel.

Em conta de hospedagem compartilhada comum, essa tela não aparece, e é esperado que não apareça: o perfil do Apache é do servidor inteiro, não da sua conta. Você consegue ver o resultado (lugar 1 e lugar 3), mas não alterar a lista.

A documentação também lembra um ponto que explica muita confusão: alguns módulos dependem de outros, e o EasyApache 4 resolve essas dependências na hora de aplicar o perfil. Por isso, pedir "instala só o mod_headers" pode acabar mexendo em mais coisa do que parece, e é um trabalho de quem administra o servidor.

Forcar o servidor a responder com uma regra-teste no .htaccess

Esse é o teste que vale mais, porque responde a pergunta que interessa: a diretiva que eu quero usar funciona aqui.

Copie o .htaccess antes de encostar nele

No Gerenciador de Arquivos, clique com o botão direito no .htaccess da pasta public_html e use Copy ou Rename para gerar htaccess-backup-2026-10-24. Se não tiver o arquivo à vista, ative Settings > Show Hidden Files. Com a cópia feita, qualquer erro 500 se resolve apagando o arquivo quebrado e renomeando a cópia de volta.

IfModule invertido: erro 500 proposital quando o modulo falta

O bloco <IfModule> executa o conteúdo só quando o módulo está carregado. Invertendo com !, você força um erro proposital quando o módulo não está lá. Cole no fim do .htaccess:

<IfModule !mod_rewrite.c>
  Isto_vai_dar_erro_500_se_mod_rewrite_faltar
</IfModule>

Recarregue o site:

Troque mod_rewrite.c por mod_headers.c, mod_expires.c ou mod_deflate.c para testar os outros. Apague o bloco depois do teste, sempre.

Esse teste tem duas limitações honestas. A primeira: ele diz que o módulo está carregado, não que o .htaccess tem permissão de usar as diretivas dele. Se o AllowOverride do servidor restringir, o módulo existe e a diretiva continua ignorada. A segunda é mais traiçoeira: com AllowOverride None, o .htaccess inteiro é ignorado, o bloco invertido nunca é lido e o site abre normal mesmo sem o módulo. Ou seja, "site abre normal" só vale como resposta se o arquivo estiver realmente sendo lido.

Para confirmar que ele é lido, escreva uma linha inválida solta no .htaccess, fora de qualquer <IfModule>, por exemplo Isto_nao_e_uma_diretiva, e recarregue o site. Erro 500 significa que o arquivo está valendo e o teste anterior é confiável. Site abrindo normal significa que o .htaccess está sendo ignorado e nenhuma conclusão pode ser tirada dele. Apague a linha em seguida. Quem libera o AllowOverride é a hospedagem.

Checagem de módulo pelo .htaccess, passo a passoFaça cópia do .htaccessRenomear para htaccess-backupLinha inválida solta no arquivoErro 500 confirma que é lidoBloco IfModule invertidoErro 500 significa módulo ausenteSite abre normalMódulo carregado no ApacheApague os blocos de testeNada de teste fica no ar
Ordem do diagnóstico no .htaccess. Sem a checagem da linha inválida, site abrindo normal não prova nada.

Modulo carregado nao e diretiva valendo: confira na resposta HTTP

Módulo carregado e diretiva valendo são coisas diferentes. Depois de configurar, confira na resposta HTTP.

Testar o 301 sem cair na armadilha da flag [L] do WordPress

Adicione uma regra simples e teste um caminho que não existe no site. Exemplo fictício, só para o teste:

<IfModule mod_rewrite.c>
  RewriteEngine On
  RewriteRule ^teste-redirect-123$ /sobre/ [R=301,L]
</IfModule>

Abra https://seudominio.com.br/teste-redirect-123. Se o navegador parar em /sobre/, o rewrite está ativo e com permissão de uso. Apague a regra em seguida.

O lugar onde você cola esse bloco muda o resultado. Cole antes da linha # BEGIN WordPress, no topo do arquivo. O bloco do WordPress termina em uma regra que manda tudo para o index.php com a flag [L], e essa flag encerra o processamento daquela passada: regra colada depois dela simplesmente não roda, e você conclui que o mod_rewrite está inativo quando ele está funcionando. Se preferir não tocar no .htaccess da raiz, crie uma pasta teste-rewrite dentro de public_html, coloque ali um .htaccess só com o bloco acima e chame https://seudominio.com.br/teste-rewrite/teste-redirect-123.

No DevTools do navegador (F12), aba Network, com Preserve log marcado, a primeira linha deve mostrar status 301 e um cabeçalho Location apontando para /sobre/.

Cache-Control e Expires nos cabecalhos provam o mod_expires

No DevTools, aba Network, recarregue a página, clique em um arquivo .css ou .jpg e olhe o painel Headers > Response Headers. Com mod_expires ativo e regra aplicada, aparece Cache-Control: max-age=... e, normalmente, um Expires com data futura. Sem nada disso, a regra não pegou.

Se preferir terminal:

curl -I https://seudominio.com.br/wp-includes/css/dashicons.min.css

O -I pede só os cabeçalhos. Procure as linhas Cache-Control e Expires na saída.

Content-Encoding: gzip prova o mod_deflate (e por que curl -I mente aqui)

O navegador só recebe resposta comprimida se pedir. No DevTools, qualquer requisição normal já envia Accept-Encoding. Clique no documento HTML principal e procure Content-Encoding: gzip em Response Headers. Pela linha de comando, é preciso pedir explicitamente:

curl -s -D - -o /dev/null -H "Accept-Encoding: gzip" https://seudominio.com.br/

Linha a linha: -s cala a barra de progresso, -D - imprime os cabeçalhos da resposta na tela, -o /dev/null joga fora o corpo (que viria comprimido e ilegível) e o -H envia o pedido de compressão. A saída esperada começa em HTTP/2 200 seguida dos cabeçalhos; procure Content-Encoding: gzip entre eles.

Evite curl -I aqui. O -I faz uma requisição HEAD, que devolve resposta sem corpo, e boa parte das configurações do Apache não comprime o que não tem corpo. A ausência de Content-Encoding em um HEAD não prova que a compressão está desligada.

Se a resposta trouxer Content-Encoding: gzip, a compressão está valendo. Um detalhe que gera falso negativo: quando há CDN ou proxy na frente, quem comprime pode ser ele, e o cabeçalho aparece mesmo com mod_deflate desligado na origem. Teste direto na origem quando quiser ter certeza.

O que so a hospedagem pode fazer, e o que mandar no chamado

Em hospedagem compartilhada, instalar ou remover módulo do Apache é operação de servidor. Não existe botão na sua conta, e isso é proposital: o perfil do EasyApache 4 vale para todos os sites da máquina.

Situação Dá para resolver sozinho Como
Descobrir se o módulo está carregado Sim apache_get_modules(), IfModule invertido
Escrever regra de rewrite, headers, expires Sim .htaccess, com backup antes
Instalar módulo ausente Não Abrir chamado no suporte
Liberar diretiva bloqueada por AllowOverride Não Abrir chamado no suporte
Trocar módulo por alternativa Às vezes Plugin que gera cache estático, CDN que comprime

Ao abrir o chamado, mande três coisas: o nome exato do módulo (mod_deflate, não "compressão"), o trecho de .htaccess que você pretende usar e o resultado do teste do IfModule invertido. Isso elimina uma rodada inteira de ida e volta.

Erro 500 depois de mexer no .htaccess: a volta em menos de um minuto

É o desfecho mais comum de mexer no .htaccess, e ele é reversível em menos de um minuto.

  1. Abra o Gerenciador de Arquivos, entre em public_html.
  2. Renomeie o .htaccess atual para htaccess-quebrado.
  3. Recarregue o site. Se voltar, o problema está no arquivo, e não no servidor.
  4. Renomeie a cópia de backup de volta para .htaccess.
  5. Reintroduza as regras uma a uma, recarregando o site a cada bloco, até achar a linha culpada.

Se o WordPress ficar sem .htaccess nenhum e os links internos derem 404, entre em Configurações > Links Permanentes no painel e clique em Salvar alterações sem mudar nada: o WordPress regrava o bloco padrão de rewrite.

E um aviso sobre diagnóstico: antes de concluir que falta módulo, confira se o log de erros do site (no painel, em Errors ou Error Log) registra algo como Invalid command. Essa mensagem é o sintoma clássico de diretiva sem o módulo correspondente, e ela nomeia a diretiva que falhou. Costuma ser a pista mais rápida de todas.

Voltar atrás depois do erro 500Renomeie o .htaccessVire htaccess-quebradoRecarregue o siteVoltou: a culpa é do arquivoRestaure a cópiaBackup volta a ser .htaccessReintroduza regra a regraRecarregue a cada blocoSem .htaccess e com 404Salve os Links Permanentes
Sequência de volta atrás depois de erro 500. Cada passo leva segundos e nenhum exige suporte.

Referências

  1. Documentação oficial (cpanel) — Apache Modules (EasyApache 4). Consultado em 2026-10-24.
Leia também