# mod_headers ausente: confirme antes de mexer no servidor

Como listar os módulos do Apache já carregados, ativar só o que falta pelo EasyApache 4 e confirmar pelo cabeçalho de resposta do próprio site.

> Na maioria dos casos o módulo já está lá. mod_headers, mod_expires e mod_deflate costumam fazer parte do perfil do EasyApache 4, e o aviso do plugin vem de uma detecção que falha quando o PHP roda via FPM. Confirme com `httpd -M` e prove pela resposta HTTP do site antes de mudar qualquer coisa no servidor.

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

---

O aviso costuma aparecer logo depois da instalação de um plugin de cache, de segurança ou de otimização de imagem: "mod_headers não está disponível no seu servidor", "mod_expires missing", "compressão GZIP desativada". O plugin não está adivinhando: ele perguntou ao Apache quais módulos estão carregados e não encontrou o que precisa, ou não conseguiu perguntar e assumiu o pior.

A tarefa aqui tem três partes: descobrir o que já está ativo, ativar só o que falta sem mexer no que funciona e provar pela resposta HTTP do próprio site que a diretiva passou a valer. O último passo é o que resolve a dúvida de verdade, porque um plugin pode continuar reclamando mesmo com o módulo ativo.

## O que mod_headers, mod_expires, mod_deflate e mod_rewrite fazem

Três deles aparecem em quase todo aviso de plugin. O quarto entra porque ele é o motor do permalink e costuma estar junto na mesma tela.

| Módulo | Para que serve | Diretiva típica no `.htaccess` | Como se prova na resposta HTTP |
|---|---|---|---||
| `mod_headers` | Adicionar, alterar ou remover cabeçalhos de resposta | `Header set X-Frame-Options "SAMEORIGIN"` | O cabeçalho pedido aparece em `curl -I` |
| `mod_expires` | Definir validade do cache do navegador por tipo de arquivo | `ExpiresByType image/webp "access plus 1 year"` | Surge `Expires:` e `Cache-Control: max-age=` |
| `mod_deflate` | Comprimir a resposta antes de enviar | `AddOutputFilterByType DEFLATE text/html` | `Content-Encoding: gzip` quando o cliente aceita |
| `mod_rewrite` | Reescrever URL (permalinks bonitos do WordPress) | Bloco `# BEGIN WordPress` | URL amigável abre sem 404 |

Na documentação do cPanel, esses módulos são pacotes do EasyApache 4, marcados e aplicados na interface do WHM ([cPanel, Apache Modules](https://docs.cpanel.net/ea4/apache/apache-modules/apache-modules/)). Ou seja, ativar não é editar arquivo de configuração na mão: é marcar o pacote e deixar o EasyApache reconstruir o perfil.

## Por que o plugin erra o diagnóstico quando o PHP roda em FPM

Plugin erra esse diagnóstico com frequência. O jeito mais comum de um plugin checar é chamar `apache_get_modules()` do PHP. Essa função só retorna a lista quando o PHP roda como módulo do Apache. Com PHP-FPM ou CGI, que é o arranjo mais comum hoje em cPanel, a função não existe ou devolve vazio, e o plugin conclui que o módulo "falta".

Então vale gastar dois minutos olhando fora do plugin.

### Testar pela resposta HTTP, sem acesso ao servidor

No seu computador, com o site no ar:

```bash
curl -sI https://seudominio.com.br/ | grep -i -E 'content-encoding|expires|cache-control|x-frame'
```

`-s` deixa silencioso, `-I` pede só os cabeçalhos, o `grep -i` filtra sem diferenciar maiúscula. Se já aparece `Cache-Control: max-age=31536000` em um arquivo estático, há alguma camada de cache funcionando. O que esse comando não distingue é se quem produziu o cabeçalho foi o Apache, um proxy na frente ou o próprio PHP.

Para a compressão, é preciso avisar que o cliente aceita:

```bash
curl -sI -H "Accept-Encoding: gzip" https://seudominio.com.br/ | grep -i content-encoding
```

Resposta esperada quando a compressão está ativa: `content-encoding: gzip`. Sem nenhuma linha de saída, ou a compressão não está ligada ou aquele tipo de conteúdo não está na lista comprimida.

### Listar os módulos carregados com httpd -M

Se você tem acesso SSH com privilégio de root (servidor dedicado ou VPS gerenciado por você), a lista de módulos carregados pelo Apache sai assim:

```bash
httpd -M
```

A saída é uma linha por módulo, no formato `headers_module (shared)`. O `(shared)` indica módulo dinâmico, carregado em tempo de inicialização por uma linha `LoadModule`; quando aparece `(static)`, o módulo foi compilado junto com o binário do Apache. Nos dois casos ele está disponível para uso no `.htaccess`. Para procurar um específico:

```bash
httpd -M | grep -E 'headers|expires|deflate|rewrite'
```

Repare no detalhe que confunde muita gente: no `.htaccess` você escreve `mod_headers`, mas o `httpd -M` imprime `headers_module`. É o mesmo módulo, com nomenclatura diferente.

Em hospedagem compartilhada você não tem esse acesso. É aceitável e normal: abra um chamado pedindo a saída de `httpd -M`, ou simplesmente pergunte se `mod_headers`, `mod_expires` e `mod_deflate` estão no perfil do EasyApache.

## Ativar o módulo que falta no WHM sem remover o que já funciona

Quem administra o servidor faz isso pela interface do EasyApache 4, que lista os módulos do Apache como pacotes selecionáveis, conforme a [documentação do cPanel](https://docs.cpanel.net/ea4/apache/apache-modules/apache-modules/).

### Onde fica o EasyApache 4 no WHM

No WHM, use a busca lateral por "EasyApache 4" e entre em **Software > EasyApache 4**. O perfil que está rodando aparece como *Currently Installed Packages*.

### Clonar o perfil atual em vez de escolher um perfil pronto

Clique em **Customize** no perfil instalado. Isso abre um assistente por etapas (Apache MPM, Apache Modules, PHP Versions, PHP Extensions, Additional Packages, Review). Não escolha um perfil pronto diferente do seu: perfil pronto troca o conjunto inteiro e pode remover extensão de PHP que o site usa.

### Marcar apenas os módulos ausentes na etapa Apache Modules

Na etapa **Apache Modules**, use o campo de busca da própria tela e procure por `headers`, `expires` ou `deflate`. Marque apenas o que estava ausente. Cada clique entra numa fila de alterações visível no rodapé.

### Ler a lista de remoções na tela Review antes de provisionar

Vá até **Review**. A tela mostra o que será instalado e o que será removido. Leia a lista de remoções com atenção: se aparecer algo que você não pediu, volte e desfaça. Só então clique em **Provision**.

O Apache reinicia ao final do provisionamento. Isso significa uma interrupção curta nas conexões. Faça fora do horário de pico e tenha backup atual, como você faria com qualquer alteração que reinicia serviço.

### O que pedir ao suporte quando a hospedagem é compartilhada

Em plano compartilhado, a decisão é do provedor. O pedido eficiente ao suporte é objetivo: "o plugin X exige mod_headers; podem confirmar se o módulo está no perfil do EasyApache deste servidor?". É comum esses três módulos já estarem no perfil do EasyApache 4, e nesse caso o problema real é o método de detecção do plugin. Confirme antes de pedir qualquer mudança.

## Escrever a diretiva no .htaccess sem derrubar o site

Com o módulo ativo, a diretiva vai para o `.htaccess` da pasta do site. Duas precauções antes.

Primeira: **baixe uma cópia do `.htaccess` atual** pelo Gerenciador de Arquivos do cPanel antes de editar. Se o site cair, você restaura o arquivo e volta ao estado anterior em segundos. Lembre de ativar "Mostrar arquivos ocultos" nas configurações do Gerenciador de Arquivos, senão o `.htaccess` não aparece.

Segunda: envolva tudo em `<IfModule>`. Diretiva de módulo ausente gera erro 500 no site inteiro. Dentro do `IfModule`, o Apache ignora o bloco se o módulo não estiver lá.

Exemplo (fictício, para ilustrar a estrutura; ajuste os tipos e os prazos ao seu caso):

```apache
<IfModule mod_headers.c>
  Header set X-Content-Type-Options "nosniff"
</IfModule>

<IfModule mod_expires.c>
  ExpiresActive On
  ExpiresByType image/webp "access plus 1 month"
  ExpiresByType text/css "access plus 1 month"
</IfModule>

<IfModule mod_deflate.c>
  AddOutputFilterByType DEFLATE text/html text/css application/javascript
</IfModule>
```

Coloque esse trecho **fora** do bloco `# BEGIN WordPress` / `# END WordPress`. O WordPress reescreve o que está entre esses marcadores quando você salva os links permanentes, e levaria suas linhas junto.

## Confirmar na resposta HTTP que a diretiva passou a valer

Salvou o arquivo. Agora confira na resposta, não no painel do plugin.

```bash
curl -sI -H "Accept-Encoding: gzip" https://seudominio.com.br/wp-content/themes/seu-tema/style.css
```

Troque `seu-tema` pelo nome da pasta do tema ativo (você vê o caminho no Gerenciador de Arquivos, em `public_html/wp-content/themes`). O arquivo precisa existir e abrir no navegador, senão a resposta será 404 e nenhum cabeçalho de cache vai aparecer. O `-H "Accept-Encoding: gzip"` avisa que o cliente aceita conteúdo comprimido, sem isso o Apache responde sem compressão e o teste de `mod_deflate` falha mesmo com o módulo ativo.

Saída esperada, se as três diretivas do exemplo estiverem valendo: uma linha `HTTP/2 200`, depois `x-content-type-options: nosniff`, `expires:` com data um mês à frente, `cache-control: max-age=2592000` e `content-encoding: gzip`. Para testar a validade de uma imagem WebP, repita o comando apontando para um arquivo `.webp` real da pasta `wp-content/uploads`.

O que procurar, conforme o que você escreveu:

| Você escreveu | Deve aparecer na resposta |
|---|---||
| `Header set X-Content-Type-Options "nosniff"` | `x-content-type-options: nosniff` |
| `ExpiresByType image/webp "access plus 1 month"` | `expires:` com data futura e `cache-control: max-age=2592000` |
| `AddOutputFilterByType DEFLATE text/css` | `content-encoding: gzip` ao pedir com `Accept-Encoding: gzip` |

Sem terminal, dá para fazer o mesmo no navegador: pressione F12, abra a aba **Network**, recarregue a página, clique na primeira requisição e leia **Response Headers**. Use uma janela anônima, porque cache do navegador pode entregar uma cópia antiga sem bater no servidor.

### Quatro motivos para o cabeçalho não aparecer no curl

- **O `.htaccess` não está sendo lido.** O Apache só obedece ao arquivo se o `AllowOverride` da pasta permitir. Em cPanel padrão isso costuma estar liberado. Para checar sem derrubar o site, acrescente um cabeçalho de teste dentro de um `IfModule` e peça a resposta: `<IfModule mod_headers.c>` na primeira linha, `Header set X-Teste "ok"` na segunda, `</IfModule>` na terceira. Salve, rode `curl -sI https://seudominio.com.br/ | grep -i x-teste` e veja se sai `x-teste: ok`. Se sair, o arquivo está sendo lido e o problema é outro; se não sair, peça ao suporte a confirmação do `AllowOverride` do seu diretório. Apague as três linhas de teste depois. Evite o truque de inserir um erro de propósito: ele devolve erro 500 e o site fica fora do ar até você desfazer.
- **Você editou o `.htaccess` errado.** Site em subdomínio ou em subpasta tem o seu próprio. Confirme o caminho no cPanel, em **Domínios**, na coluna de raiz do documento.
- **Tem cache na frente.** CDN ou proxy pode estar devolvendo uma cópia guardada. Limpe o cache da CDN e repita o `curl` apontando direto para o IP de origem, se o provedor permitir.
- **Outro plugin já define o mesmo cabeçalho.** `Header set` sobrescreve, `Header append` acrescenta. Dois plugins mexendo no mesmo cabeçalho produzem resultado confuso; escolha um só.

## Quando o aviso do plugin pode ser ignorado com segurança

Acontece, e não significa que o servidor esteja errado. Se o `curl -I` mostra o cabeçalho e a compressão funciona, a função de detecção do plugin é que não enxerga a configuração, normalmente por causa do PHP rodar via FPM.

Nesse cenário, a decisão é prática: ignore o aviso e desative no plugin a opção que ele diz não conseguir aplicar, deixando a regra no `.htaccess`. Duplicar a mesma função em dois lugares é o caminho mais curto para um cabeçalho repetido ou um `max-age` contraditório.

E vale dizer o óbvio contra o próprio interesse de quem vende hospedagem: ativar `mod_deflate` e `mod_expires` não conserta um site lento por consulta pesada ao banco, por imagem de 4 MB servida em tamanho original ou por trinta plugins ativos. Eles cortam bytes transferidos e idas ao servidor em visita repetida. É ganho real, mas é a última camada, não a primeira.

## A ordem de trabalho em sete passos

- Rode `curl -sI` no seu site e veja quais cabeçalhos já existem.
- Com acesso root, confirme com `httpd -M | grep -E 'headers|expires|deflate'`. Sem acesso, pergunte ao suporte.
- Se faltar algum, ative pelo WHM em **Software > EasyApache 4 > Customize > Apache Modules**, revise e provisione.
- Baixe uma cópia do `.htaccess` antes de editar.
- Escreva a diretiva dentro de `<IfModule>`, fora do bloco do WordPress.
- Confirme na resposta HTTP, em janela anônima ou por `curl`.
- Se o plugin insistir no aviso mas a resposta estiver correta, confie na resposta.

A referência para a etapa de ativação é a documentação oficial do cPanel sobre [Apache Modules no EasyApache 4](https://docs.cpanel.net/ea4/apache/apache-modules/apache-modules/). As diretivas de exemplo acima são ilustrativas: troque tipos de arquivo, prazos e nomes de cabeçalho pelo que o seu site precisa antes de colar.

