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.

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
- O que mod_rewrite, mod_headers, mod_expires e mod_deflate fazem no servidor
- Ver a lista de modulos carregados com apache_get_modules()
- A tela Apache Modules do EasyApache 4, e por que ela nao aparece na sua conta
- Forcar o servidor a responder com uma regra-teste no .htaccess
- Modulo carregado nao e diretiva valendo: confira na resposta HTTP
- O que so a hospedagem pode fazer, e o que mandar no chamado
- 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:
- Site abre normal: o
mod_rewriteestá carregado. - Erro 500: o módulo não está carregado.
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.
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.
- Abra o Gerenciador de Arquivos, entre em
public_html. - Renomeie o
.htaccessatual parahtaccess-quebrado. - Recarregue o site. Se voltar, o problema está no arquivo, e não no servidor.
- Renomeie a cópia de backup de volta para
.htaccess. - 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.
Referências
- Documentação oficial (cpanel) — Apache Modules (EasyApache 4). Consultado em 2026-10-24.