Saltar para o conteúdo

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.

4 min de leitura

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=pt vs Cookie: 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

← Toda a documentação