Pular para o conteúdo
Criação de Apps

Cache-Control: como os cabeçalhos HTTP controlam o cache do site

Resposta rápida

Cache-Control é um cabeçalho HTTP enviado pelo servidor que diz ao navegador e aos intermediários se podem guardar uma resposta e por quanto tempo. Com ele você acelera visitas repetidas e reduz a carga no servidor, sem deixar o usuário preso a uma versão antiga.

Neste artigo
  1. O que é o Cache-Control
  2. As diretivas mais usadas
  3. Como escolher o tempo certo
  4. Como conferir se está funcionando

Quando alguém abre seu site pela segunda vez, o ideal é que o navegador reaproveite imagens, estilos e scripts que já baixou. Quem manda nessa decisão é o servidor, por meio do cabeçalho Cache-Control. Configurá-lo bem faz o site parecer mais rápido, mas configurá-lo mal pode fazer o usuário ver uma versão velha da página por dias.

O que é o Cache-Control

Toda resposta HTTP traz cabeçalhos com instruções. O Cache-Control é o que diz se aquela resposta pode ser guardada e por quanto tempo. Ele vale para o navegador do visitante e também para intermediários, como proxies e uma CDN.

O cache existe para evitar viagens desnecessárias. Se o arquivo não mudou, não faz sentido baixá-lo de novo. Isso poupa dados do visitante e trabalho do seu servidor. Para uma visão mais ampla do que pesa no carregamento, veja como deixar o site mais rápido.

As diretivas mais usadas

Você escreve as diretivas separadas por vírgula. As principais:

  • max-age=NÚMERO: por quantos segundos o navegador pode reutilizar a resposta sem perguntar nada ao servidor.
  • public: a resposta pode ser guardada por qualquer cache, inclusive de intermediários.
  • private: só o navegador do usuário pode guardar. Serve para conteúdo personalizado.
  • no-cache: pode guardar, mas precisa validar com o servidor antes de reutilizar.
  • no-store: não guardar em lugar nenhum. Use em páginas com dados sensíveis, como extratos ou telas de conta.
  • immutable: indica que o arquivo nunca vai mudar durante o prazo, então o navegador nem precisa revalidar.

Um exemplo comum para um arquivo de estilo com nome versionado seria max-age de um ano com public e immutable. Para a página HTML principal, algo curto ou no-cache costuma ser mais seguro.

Como escolher o tempo certo

A regra prática é separar os arquivos em dois grupos:

  1. Arquivos que mudam de nome quando mudam de conteúdo, como estilo.a1b2c3.css. Podem ter cache muito longo, porque uma nova versão terá um nome novo e o navegador a buscará naturalmente.
  2. Arquivos com nome fixo, como a página inicial ou um JSON de dados. Precisam de tempo curto ou de validação, senão as atualizações demoram a aparecer.

A validação funciona com os cabeçalhos ETag e Last-Modified. O navegador pergunta se a versão dele ainda é a atual, e o servidor responde que sim, sem reenviar o arquivo. É mais leve do que baixar tudo de novo.

Como conferir se está funcionando

Abra as ferramentas de desenvolvedor do navegador, vá na aba Rede e clique em um arquivo. Nos cabeçalhos da resposta, procure Cache-Control. Recarregue a página e observe a coluna de tamanho: arquivos vindos do cache aparecem como memória ou disco, em vez de um tamanho de download.

Se você alterou um arquivo e o visitante continua vendo o antigo, o problema quase sempre é um max-age longo em um arquivo de nome fixo. A saída é versionar o nome do arquivo ou reduzir o tempo.

Cada servidor ou hospedagem configura isso de um jeito, e os nomes dos menus mudam. Consulte a documentação da sua plataforma para saber onde definir esses cabeçalhos.

  • Cache
  • HTTP
  • Desempenho
  • Sites

Perguntas frequentes

Qual a diferença entre no-cache e no-store?

No-cache permite guardar a resposta, mas obriga o navegador a confirmar com o servidor se ela ainda vale antes de usá-la. No-store proíbe guardar a resposta em qualquer lugar, e serve para dados sensíveis.

Posso usar cache longo em todos os arquivos?

Só nos arquivos que mudam de nome quando mudam de conteúdo. Para páginas HTML, prefira um tempo curto ou validação, para que as atualizações apareçam logo.

Leia também

Dicas de Internet

CDN: o que é e por que ela faz os sites carregarem mais rápido

Por trás de muitos sites rápidos existe uma rede de cópias espalhadas pelo mundo.

· 2 min de leitura
Criação de Apps

Como deixar o site mais rápido: o que realmente pesa no carregamento

Um roteiro para medir a lentidão do site e corrigir primeiro o que mais pesa.

· 5 min de leitura
Criação de Apps

Redirecionamento 301 e 302: quando usar cada um no seu site

Mudou o endereço de uma página? O tipo de redirecionamento define o que navegadores e buscadores entendem.

· 3 min de leitura
Criação de Apps

Acessibilidade no site: o básico para começar sem ser especialista

Um site acessível é melhor para todos: poucos ajustes já eliminam barreiras comuns.

· 2 min de leitura

Deixe seu comentário