Como configurar cabeçalhos de cache (cache-control) personalizados por tipo de arquivo

Cache-Control personalizado por tipo de arquivo: o segredo de um site rápido

Olá! Aqui é a Sensei da GeHost 🧘‍♀️ e hoje vamos falar de um ajuste simples que faz muita diferença na velocidade do seu site: os cabeçalhos de Cache-Control configurados por tipo de arquivo. Calma, não é nada complicado — vou te guiar passo a passo, com calma e carinho, como sempre.

O que é o Cache-Control, afinal?

Todo arquivo que o navegador do visitante baixa do seu site (uma imagem, um CSS, um script JavaScript) pode ser guardado (cacheado) no computador dele por um tempo. Assim, na próxima visita, o navegador não precisa baixar tudo de novo — ele já tem a cópia guardada. Isso deixa o carregamento muito mais rápido e ainda economiza tráfego.

O cabeçalho Cache-Control é a "instrução" que o servidor manda pro navegador dizendo: "guarde este arquivo por X tempo antes de checar de novo".

Por que configurar por tipo de arquivo?

Nem todo arquivo deve ter o mesmo tempo de cache. Pense assim:

• Imagens, ícones e fontes quase nunca mudam — podem ficar em cache por muito tempo.
• CSS e JavaScript mudam de vez em quando (quando você atualiza o site) — merecem um tempo de cache médio.
• Páginas HTML costumam mudar com mais frequência — geralmente é melhor um cache mais curto ou nenhum, pra garantir que o visitante sempre veja a versão mais recente.

Dica da Sensei: cache "genérico demais" (tudo com o mesmo tempo) é o erro mais comum. Ou o site fica lento porque quase nada é cacheado, ou o visitante vê conteúdo desatualizado porque tudo ficou cacheado por tempo demais.

Passo a passo: configurando pelo arquivo .htaccess

Nos planos de hospedagem GeHost, o jeito mais comum de configurar isso é editando o arquivo .htaccess do seu site pelo cPanel. Vamos lá:

1. Acesse o painel.gehost.com.br e entre no cPanel da sua hospedagem.
2. Abra o Gerenciador de Arquivos (File Manager).

3. Entre na pasta public_html (ou na subpasta do domínio/subdomínio que você quer ajustar).
4. Ative a opção "Mostrar arquivos ocultos" nas configurações do Gerenciador, se o .htaccess não aparecer na lista (arquivos que começam com ponto ficam ocultos por padrão).
5. Clique com o botão direito no .htaccess e escolha Editar. Se o arquivo não existir ainda, você pode criar um novo com esse nome exato.
6. Adicione o bloco de configuração de cache (veja o exemplo abaixo) antes de qualquer regra de redirecionamento que já exista no arquivo.
7. Salve o arquivo.

Exemplo de configuração por tipo de arquivo

Este é um modelo comum, usando o módulo mod_expires (padrão no Apache/cPanel):

<IfModule mod_expires.c>
  ExpiresActive On

  # Imagens e ícones - cache longo
  ExpiresByType image/jpeg "access plus 1 year"
  ExpiresByType image/png "access plus 1 year"
  ExpiresByType image/webp "access plus 1 year"
  ExpiresByType image/x-icon "access plus 1 year"

  # Fontes - cache longo
  ExpiresByType font/woff2 "access plus 1 year"

  # CSS e JavaScript - cache médio
  ExpiresByType text/css "access plus 1 month"
  ExpiresByType application/javascript "access plus 1 month"

  # HTML - cache curto (ou nenhum)
  ExpiresByType text/html "access plus 1 hour"
</IfModule>

Você pode ajustar os valores ("1 year", "1 month", "1 hour" etc.) de acordo com a frequência com que cada tipo de arquivo muda no seu site.

Dica da Sensei: se o seu site tem tema/plugin (WordPress, por exemplo), verifique se ele já tem uma seção de cache no próprio .htaccess antes de duplicar as regras — duas configurações conflitantes podem gerar comportamento inesperado.

Como testar se funcionou

1. Abra seu site no navegador.
2. Abra as Ferramentas do Desenvolvedor (tecla F12) e vá na aba Rede/Network.
3. Recarregue a página e clique em um dos arquivos (uma imagem, por exemplo).
4. Procure pelo cabeçalho de resposta Cache-Control ou Expires — se ele aparecer com o tempo que você configurou, deu tudo certo! 🎉

Erros comuns (pra você não cair neles)

• Cache longo demais em CSS/JS: se você atualizar o design do site, os visitantes podem continuar vendo a versão antiga por semanas. Nesse caso, o ideal é combinar cache longo com uma técnica de "versionamento" do nome do arquivo (isso geralmente é feito pelo próprio sistema/tema que você usa).
• Editar o .htaccess sem fazer backup: antes de qualquer alteração, copie o conteúdo atual do arquivo em um bloco de notas. Assim, se algo der errado, você reverte rapidinho.
• Esquecer de testar em uma aba anônima: o cache do seu próprio navegador pode "mascarar" o resultado — sempre teste em uma janela anônima/privada.

E é isso! Com esse ajuste, seu site fica mais leve e rápido pros visitantes, principalmente em conexões mais lentas ou no celular. Qualquer dúvida na hora de editar o .htaccess, nosso suporte está por aqui pra te ajudar. Um abraço da sua Sensei! 🌸