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.
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údo | TTL recomendada | Notas |
|---|---|---|
| Logótipo, ícones (não mudam) | 1 ano (31536000) | Versiona o nome do ficheiro ao mudar (logo-v2.png) |
| CSS, JavaScript da aplicação | 1 dia a 1 ano | Versiona com hash no nome (app.a3f8.js) |
| Imagens de produto | 1 a 7 dias | Re-upload com nome novo se mudar |
| Imagens de blog / artigos | 7 dias a 1 mês | Raramente trocadas |
| Páginas de blog | 5 min a 1 hora | Suficiente para feed e comentários novos aparecerem |
| Homepage | 1 a 5 min | Atualização visível ~rapidamente |
| Catálogo de produtos (sem stock) | 5 a 15 min | Aceita pequeno atraso |
| Catálogo com stock | 0 (sem cache) | Cada visitante vê o stock atual |
| Carrinho, login, /minha-conta | 0 (sem cache) | Por utilizador |
A lógica do TTL longo + purga ao deploy
A combinação mais eficiente para sites com builds:
- Asset hashing no build: o teu build process gera ficheiros com hash do conteúdo (
app.4f8a2.js,style.c9d1e.css). - TTL muito longa nos assets: 1 ano (
max-age=31536000, immutable). - 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). - 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-storeouprivate. - 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:ouCookie: 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
- Cache na FortFox — fundamentos.
- Variar por query string — para URLs com parâmetros.