# 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.

> 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.

João Rizzon · 2026-10-25 · Infraestrutura web

---

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](https://docs.cpanel.net/ea4/apache/apache-modules/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
<?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](https://docs.cpanel.net/ea4/apache/apache-modules/apache-modules/).

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`:

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

Recarregue o site:

- Site abre normal: o `mod_rewrite` está 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:

```apache
<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:

```bash
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:

```bash
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 `.htaccess` atual para `htaccess-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.

