Variar por query string
Por defeito, a FortFox trata "/produtos" e "/produtos?cor=azul" como o mesmo pedido para fins de cache. Ativar "variar por query string" obriga-a a manter cópias separadas — útil quando o conteúdo muda conforme os parâmetros.
A intuição
Considera dois pedidos a /produtos:
Pedido A: /produtos?cor=azul
Pedido B: /produtos?cor=verde
Se o teu servidor responde conteúdo diferente (filtragem por cor), são dois pedidos lógicos distintos. A FortFox tem de:
- Cachar A e B separadamente.
- Servir cada um conforme a query string.
Se o teu servidor responde o mesmo independente da query (ex.: a página tem filtragem só em JS, lado do cliente), são o mesmo pedido lógico. A FortFox deve:
- Cachar uma única cópia.
- Servir a todos os pedidos
/produtos*, ignorando a query string.
O knob "Variar por query string" decide qual destes dois comportamentos é o teu.
Quando ligar
Liga "variar por query string" se:
- Tens listagens com filtros server-side:
/produtos?categoria=cozinha,/blog?tag=receitas,/pesquisa?q=.... - A query string controla a ordenação ou paginação:
?ordenar=preco,?pagina=2. - A query string controla a língua:
?lang=pt.
Cada combinação de parâmetros gera uma entrada de cache separada.
Quando NÃO ligar
Mantém desligada se:
- A query string é só para tracking de marketing:
?utm_source=facebook,?gclid=...,?fbclid=.... - A query string é um timestamp anti-cache que o browser adiciona:
?v=1718909323. - A query string é um ID de sessão ou outro valor por-utilizador.
Se ligares "variar por query string" nestes casos, a cache fica inutilizada: cada visitante gera uma URL única (?utm_campaign=xyz, ?fbclid=...), todas falham hit, todas vão ao servidor. Cache hit rate cai para 0%.
O caso misto
Tens uma página /produtos?categoria=X (importante para cache) que também recebe ?utm_* (irrelevante).
Hoje na FortFox: ligar "variar por query string" trata os parâmetros como um todo. URL com tracking diferente = miss.
Workaround: implementa no teu servidor uma redirect ou canonicalização que tira os ?utm_* antes de chegar à página real. O servidor responde já sem tracking, e a cache funciona.
Futuro: permitir "variar só por estes parâmetros e ignorar os outros" — está no roadmap.
Exemplos práticos
E-commerce com filtros
Regra: caminho /produtos*, TTL 300, Variar por query string: SIM
/produtos?cat=cozinha e /produtos?cat=jardim ficam em cache separada. Cada filtragem popular vira hit rapidamente.
Blog com tags
Regra: caminho /blog*, TTL 600, Variar por query string: SIM
/blog?tag=receitas e /blog?tag=viagens cacheadas separadamente.
Homepage com tracking
Regra: caminho /, TTL 60, Variar por query string: NÃO
/?utm_source=facebook e /?utm_campaign=spring servem da mesma cache. Hit rate alto. Os parâmetros vão ao analytics no cliente; a página é a mesma.
Pesquisa
Regra: caminho /pesquisa*, TTL 300, Variar por query string: SIM
/pesquisa?q=teclado+gaming e /pesquisa?q=monitor em cache separada. Pesquisas populares ficam hit; pesquisas únicas são miss (esperado).
Variar por cookies
A opção paralela é "Variar por cookies" — cria entradas separadas conforme o Cookie: header. Quase nunca queres isto:
- Cada visitante normalmente tem um cookie de sessão único → cache cai para 0%.
- Útil apenas para sites multilíngue que usam cookie para a língua:
Cookie: lang=ptvsCookie: lang=en. Mesmo assim, hoje recomendamos meter a língua no URL (/pt/,/en/) em vez de cookie.
Como debug
curl com -I no edge (header) mostra X-FortFox-Cache: HIT|MISS. Testa:
curl -I "https://o-meu-site.com/produtos?cor=azul"
curl -I "https://o-meu-site.com/produtos?cor=azul" # esperado: HIT
curl -I "https://o-meu-site.com/produtos?cor=verde" # esperado: MISS (regra c/ variar)
# ou HIT (regra sem variar)
Se vês comportamento inesperado, ajusta a regra.
Em mais detalhe técnico
Cache key construction:
- Default:
scheme + host + uri_path - Com variar query:
+ "?" + sorted(query_args) - Com variar cookies:
+ "|" + cookie_header
Ordenação da query string: a FortFox ordena alfabeticamente os parâmetros ao construir a key. ?a=1&b=2 e ?b=2&a=1 partilham cache (esperado).
Parâmetros multi-valor: ?tag=foo&tag=bar é tratado como tag=bar,foo (concatenação por chave). Casos esotéricos podem comportar-se de forma surpreendente — para esses, prefere URLs distintos.
Vary header do servidor: a FortFox respeita o header Vary: enviado pela origem. Se a origem manda Vary: Accept-Language, a FortFox automaticamente cria entries separadas por valor desse header — mesmo sem o utilizador configurar nada. Comportamento HTTP standard.
Limites práticos: cada entry de cache custa storage. 100 paths × 50 combinações de query = 5000 entries — confortável. 100 paths × milhões de combinações (tracking IDs) = problema. Sempre que ligas "variar por query", confirma que o universo de combinações é razoável.
Próximos passos
- Cache na FortFox — fundamentos.
- Duração da cache (TTL) — quanto tempo guardar.