blog
Infraestrutura web

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.

JR · · 9 min de leitura · 2 tabelas · 6 blocos de código

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
  1. O que mod_headers, mod_expires, mod_deflate e mod_rewrite fazem
  2. Por que o plugin erra o diagnóstico quando o PHP roda em FPM
  3. Ativar o módulo que falta no WHM sem remover o que já funciona
  4. Escrever a diretiva no .htaccess sem derrubar o site
  5. Confirmar na resposta HTTP que a diretiva passou a valer
  6. Quando o aviso do plugin pode ser ignorado com segurança
  7. 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.

Ordem de checagem antes de mexer no servidorPlugin acusa módulo ausenteAviso no painel do WordPressRode curl -sI no siteLeia os cabeçalhos da respostaCabeçalho aparece?Se sim, o módulo já funcionaCom root: httpd -MProcure headers, expires, deflateSem root: pergunte ao suportePeça o perfil do EasyApacheSó então ative o que faltaConfirme antes de mudar
A resposta HTTP decide, não o aviso do plugin.

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.

Caminho no EasyApache 4 dentro do WHMCustomizeClone o perfil instaladoApache ModulesMarque só o que faltaReviewLeia a lista de remoçõesProvisionApache reinicia ao final
Perfil pronto troca o conjunto inteiro; clonar preserva o que funciona.

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

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

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

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