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.

Resposta curta: 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.
Neste artigo
- O que mod_headers, mod_expires, mod_deflate e mod_rewrite fazem
- Por que o plugin erra o diagnóstico quando o PHP roda em FPM
- Ativar o módulo que falta no WHM sem remover o que já funciona
- Escrever a diretiva no .htaccess sem derrubar o site
- Confirmar na resposta HTTP que a diretiva passou a valer
- Quando o aviso do plugin pode ser ignorado com segurança
- A ordem de trabalho em sete passos
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). 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:
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:
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:
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:
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.
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):
<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.
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
.htaccessnão está sendo lido. O Apache só obedece ao arquivo se oAllowOverrideda pasta permitir. Em cPanel padrão isso costuma estar liberado. Para checar sem derrubar o site, acrescente um cabeçalho de teste dentro de umIfModulee peça a resposta:<IfModule mod_headers.c>na primeira linha,Header set X-Teste "ok"na segunda,</IfModule>na terceira. Salve, rodecurl -sI https://seudominio.com.br/ | grep -i x-testee veja se saix-teste: ok. Se sair, o arquivo está sendo lido e o problema é outro; se não sair, peça ao suporte a confirmação doAllowOverridedo 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
.htaccesserrado. 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
curlapontando direto para o IP de origem, se o provedor permitir. - Outro plugin já define o mesmo cabeçalho.
Header setsobrescreve,Header appendacrescenta. 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 -sIno 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
.htaccessantes 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. 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.
Referências
- Documentação oficial (cpanel) — Apache Modules (EasyApache 4). Consultado em 2026-10-24.