Saltar para o conteúdo

Duração da cache (TTL)

Quanto tempo a FortFox guarda uma cópia antes de ir buscar uma versão fresca ao servidor. Mais tempo = mais hits e menos carga; menos tempo = conteúdo mais atual. Equilibrar é a arte.

5 min de leitura

A escolha em três decisões

1. Quanto pode o visitante ver desatualizado e estar tudo bem?

  • 0 segundos → não cachas
  • Alguns minutos → 60-300
  • Algumas horas → 3600-21600
  • Um dia → 86400
  • Uma semana → 604800

2. Tens controlo para purgar?

  • Sim, automatizado no deploy → podes usar TTL longa (24 h+) com purga ao publicar.
  • Sim, manual → TTL média (1 h), purgas quando publicas algo importante.
  • Não → TTL = quanto consegues tolerar de "ficar fora" no pior caso.

3. O conteúdo é o mesmo para todos os visitantes?

  • Sim → cache normal.
  • Depende da query string → ativa "Variar por query string" e usa TTL normal.
  • Depende do cookie/sessão → quase nunca caches. Se tiveres mesmo de cachar, usa TTL muito baixa.

Valores típicos por tipo de conteúdo

ConteúdoTTL recomendadaNotas
Logótipo, ícones (não mudam)1 ano (31536000)Versiona o nome do ficheiro ao mudar (logo-v2.png)
CSS, JavaScript da aplicação1 dia a 1 anoVersiona com hash no nome (app.a3f8.js)
Imagens de produto1 a 7 diasRe-upload com nome novo se mudar
Imagens de blog / artigos7 dias a 1 mêsRaramente trocadas
Páginas de blog5 min a 1 horaSuficiente para feed e comentários novos aparecerem
Homepage1 a 5 minAtualização visível ~rapidamente
Catálogo de produtos (sem stock)5 a 15 minAceita pequeno atraso
Catálogo com stock0 (sem cache)Cada visitante vê o stock atual
Carrinho, login, /minha-conta0 (sem cache)Por utilizador

A lógica do TTL longo + purga ao deploy

A combinação mais eficiente para sites com builds:

  1. Asset hashing no build: o teu build process gera ficheiros com hash do conteúdo (app.4f8a2.js, style.c9d1e.css).
  2. TTL muito longa nos assets: 1 ano (max-age=31536000, immutable).
  3. TTL curta no HTML: 5-60 s. O HTML referencia os assets pelo hash; quando publicas novo HTML, ele aponta para app.b7e3f.js (nome diferente).
  4. No deploy: os assets novos têm hashes diferentes → cache miss natural. Os antigos vão lá ficar uns dias (não fazem mal) e depois são despejados por LRU.

Resultado: visitantes recebem CSS/JS instantâneo (cache hit), mas a versão mais recente é servida sem purga explícita. Hit rate típico nestes setups: >90%.

Quando usar TTL curtíssima (1-60 s)

A "microcache" — TTL muito baixa em páginas dinâmicas que recebem muito tráfego.

Cenário: homepage dinâmica recebe 100 req/s. Sem cache, 100 req/s ao servidor. Com TTL = 5 s, são 0.2 req/s ao servidor (uma vez a cada 5 s). Visitante vê conteúdo no máximo 5 s atrasado, o que para uma homepage é invisível.

Útil para:

  • Homepages com conteúdo curado
  • Listagens de "mais recentes"
  • Endpoints de API populares com dados que mudam por minuto

TTL nas resposta do servidor (Cache-Control)

Se o teu servidor envia headers Cache-Control, a FortFox respeita-os. O TTL efetivo é o mínimo entre o configurado na regra e o anunciado pelo servidor:

Servidor envia: Cache-Control: max-age=300
Regra FortFox: TTL 3600

Resultado: a entrada é cachada por 300 s (o mais conservador).

Isto evita que a FortFox sirva conteúdo mais "antigo" do que o servidor quer. Para uma regra dominar mesmo, configura o servidor para Cache-Control: max-age=86400 ou similar, OU usa override no painel (futuro).

Renovação automática (stale-while-revalidate)

Quando a TTL acaba, em vez de fazer o próximo visitante esperar pela revalidação:

  • O edge devolve a versão expirada ao visitante (resposta rápida).
  • Em paralelo, vai buscar a nova ao servidor.
  • Próximos visitantes recebem a fresca.

Permite TTL curtas sem penalizar latência. Ativo por defeito numa janela curta (stale-while-revalidate: 30).

O que NUNCA aparece em cache

Mesmo com regra, certas respostas nunca são cacheadas:

  • Resposta com Cache-Control: no-store ou private.
  • Resposta com Set-Cookie: (a não ser que ativas "Variar por cookies", o que requer cuidado).
  • Métodos não-GET (POST, PUT, DELETE, PATCH).
  • Códigos HTTP de erro 5xx (defeito; configurável).
  • Pedidos com header Authorization: ou Cookie: session=... (defeito).
Em mais detalhe técnico

Implementação: proxy_cache do nginx com proxy_cache_valid <ttl> por path-pattern. Cache key estendida com query string / cookies conforme a regra.

Cabeçalho X-FortFox-Cache:

  • HIT: serviço do cache (não tocou no servidor).
  • MISS: servidor foi consultado.
  • STALE: serviu cópia expirada enquanto revalida em paralelo.
  • BYPASS: regra ou request impedia uso de cache.
  • EXPIRED: encontrou cópia mas expirada; revalidou no momento.

Stale-while-revalidate config: proxy_cache_use_stale updating http_500 http_502 http_503 http_504. Quando o servidor de origem está em erro, a FortFox serve a versão antiga em vez de propagar o erro.

Negative caching (futuro): cachar respostas de erro (404, 500) por curto tempo para evitar martelar a origem quando algo está partido. Hoje não implementado por defeito.

ETags / Last-Modified: a FortFox suporta revalidação condicional. Quando a TTL expira, faz If-None-Match ao servidor; se o servidor responde 304 Not Modified, mantém a cópia em cache e reseta a TTL. Reduz tráfego mesmo quando precisa de revalidar.

Próximos passos

← Toda a documentação