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:
- 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.
- 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.