blog
Infraestrutura web

Cache no PrestaShop sem misturar o carrinho dos clientes

A lista de exclusão pronta por rota e por parâmetro, a instalação do módulo oficial e a conferência com curl que prova que a categoria entrou no cache e o checkout ficou fora.

JR · · 7 min de leitura · 2 tabelas · 3 blocos de código

Resposta curta: Exclua do cache as rotas de sessão do PrestaShop antes de ligar o cache de servidor: /carrinho, /pedido, /minha-conta, /login, /comparacao-produtos e toda URL com token=, id_cart=, ajax= ou action=. Depois confirme com curl -sI que a categoria responde hit e o carrinho não responde hit nenhuma vez.

Neste artigo
  1. O carrinho de um visitante aparecendo para outro é cache, não invasão
  2. As rotas e os parâmetros do PrestaShop que nunca podem ser cacheados
  3. O módulo de cache não liga o cache sozinho
  4. Meça o time_starttransfer três vezes antes e três depois
  5. Checklist que você repete em cada loja
  6. O que o cache não resolve: consulta lenta, módulo pesado e checkout
  7. Como explicar ao lojista por que o carrinho não entra no cache

O carrinho de um visitante aparecendo para outro é cache, não invasão

Você liga o cache de servidor na loja PrestaShop do cliente, o TTFB da categoria despenca e tudo parece bem. Dois dias depois chega o print: um cliente abriu o site e viu um produto no carrinho que ele nunca adicionou. Ou abriu /minha-conta e apareceu o nome de outra pessoa.

Não é invasão nem bug do PrestaShop. É cache servindo HTML público para rota que deveria ser privada. A página do carrinho foi gerada uma vez, guardada pelo servidor e devolvida igual para todo mundo que pediu aquela URL.

O conserto não é desligar o cache. É excluir as rotas certas antes de ligar, e conferir com cabeçalho e TTFB que categoria entrou e checkout ficou de fora. É isso que está abaixo, em formato que você copia de loja para loja.

As rotas e os parâmetros do PrestaShop que nunca podem ser cacheados

PrestaShop gera HTML dependente de sessão em um conjunto previsível de controllers. Cada um deles tem URL amigável (que muda conforme o idioma e o SEO configurado em Parâmetros da loja > Tráfego e SEO, na seção de URLs reescritas; no PrestaShop 1.6 a mesma tela fica em Preferências > SEO e URLs) e uma URL de controller interna.

Rota (URL amigável típica) Controller Por que nunca cachear
/carrinho cart Conteúdo é a sessão do visitante
/pedido order Etapas de checkout, endereço, frete
/minha-conta my-account Dados cadastrais do cliente
/historico-de-encomendas history Pedidos do cliente logado
/detalhes-da-encomenda order-detail Documento individual
/login e /identidade authentication, identity Formulário com token
/enderecos e /endereco addresses, address Dados pessoais
/comparacao-produtos products-comparison Lista montada na sessão
/pesquisa search Resultado varia por query, polui o cache
/nota-de-credito credit-slip Documento fiscal individual
/modulo/... (callbacks de pagamento) módulos Retorno de gateway, token único

E os parâmetros de query. Qualquer URL que carregue um destes deve ficar fora, mesmo que o caminho seja de uma rota pública:

Parâmetro Onde aparece
token= Praticamente todo formulário e ação autenticada
id_cart= Retomada de carrinho, links de recuperação
ajax= Chamadas do tema e de módulos
action= Add to cart, update, delete
add=, delete=, update= Operações diretas no carrinho
id_customer= Links individuais
back= Redirecionos pós-login
id_order=, id_order_state= Confirmação e status
secure_key= Confirmação de pagamento

URL amigável traduzida: a exclusão precisa cobrir todos os idiomas ativos

Se a loja é multilíngue, /carrinho em português convive com /panier ou /cart. A exclusão por caminho precisa cobrir todas as variantes ativas. A forma mais segura de levantar isso é abrir Parâmetros da loja > Tráfego e SEO no admin (em 1.6, Preferências > SEO e URLs) e copiar a coluna de URL reescrita de cada controller da tabela acima, idioma por idioma. Em loja de um idioma só isso leva dois minutos; em loja de três, leva seis e evita o print do carrinho trocado.

O módulo de cache não liga o cache sozinho

A documentação oficial do LiteSpeed Cache para PrestaShop (docs.litespeedtech.com/lscache/lscps/installation) descreve a instalação pelo próprio painel do PrestaShop e, para PrestaShop 1.7+, também por Composer. O ponto que importa para a agência: o módulo não cria o cache sozinho. Ele comunica ao servidor o que pode ser cacheado e dispara a purga quando o conteúdo muda. O cache de servidor precisa estar ligado no painel de hospedagem.

Ligue o cache de servidor no painel antes de instalar o módulo

Antes do módulo. Se o cache de servidor estiver desligado, o módulo instala, ativa e não muda nada, e você perde tempo procurando erro no lugar errado.

Instale e ative o módulo no gerenciador de módulos

No admin do PrestaShop, Módulos > Gerenciador de módulos, envie o pacote e ative. Módulo instalado mas desativado não marca página alguma como cacheável: ele precisa ficar ativo e o cache de servidor precisa continuar habilitado no painel.

Lance as exclusões antes de abrir a loja para o público

Na tela de configuração do módulo, lance as rotas e os parâmetros das duas tabelas acima. Se a sua configuração de exclusão fica no nível do servidor, use o campo equivalente do painel. A ordem importa: exclusão primeiro, cache ligado depois.

Purgue o cache inteiro, não só a home

Qualquer HTML gerado antes das exclusões pode estar contaminado. Purgue o cache inteiro da loja ao terminar a configuração, não só o da home.

Ordem de implantação do cache na lojaLevantar rotasURLs reescritas de todos idiomasLigar cache no painelAntes de instalar o móduloInstalar e ativar móduloGerenciador de módulos do PrestaShopLançar exclusõesRotas privadas e parâmetrosPurgar cache inteiroNão só a home

Meça o time_starttransfer três vezes antes e três depois

Não confie em "ficou mais rápido". Meça a mesma URL, no mesmo lugar, antes e depois. O número que interessa aqui é o time_starttransfer do curl: o tempo até o primeiro byte do corpo chegar. É o que o cache de página inteira ataca.

Escolha uma URL de categoria com bastante produto, que é onde o PrestaShop costuma penar, e rode três vezes antes de ativar o cache:

for i in 1 2 3; do
  curl -s -o /dev/null -w '%{time_starttransfer}\n' \
    'https://loja-do-cliente.com.br/23-camisetas'
done

Ative o cache, purgue, abra a URL uma vez no navegador para popular, e rode as mesmas três medidas. Os números do antes e do depois são os da sua loja, no seu servidor, com o seu tema: não existe valor universal para copiar daqui.

Como provar que a categoria entrou no cache

curl -sI 'https://loja-do-cliente.com.br/23-camisetas' | grep -i x-litespeed-cache

Na primeira chamada depois da purga, espere miss. Na segunda, hit. Se continuar miss sempre, o módulo não está conseguindo marcar a página como cacheável, ou algo no tema está enviando cabeçalho de no-cache.

Como provar que o checkout ficou fora do cache

curl -sI 'https://loja-do-cliente.com.br/carrinho' | grep -i x-litespeed-cache

Aqui o resultado correto é nenhuma linha, ou um cabeçalho que não indique hit. Se /carrinho responder hit, pare tudo, purgue e revise a exclusão: é exatamente essa resposta que produz o carrinho misturado.

Repita o teste de cabeçalho em /pedido, /minha-conta e /login. São quatro comandos e cobrem o grosso do risco.

Teste com dois navegadores e sessão de verdade

Cabeçalho não pega tudo. Abra a loja em dois navegadores diferentes (ou um normal e um anônimo), adicione um produto em um deles, recarregue a categoria e o carrinho no outro. Se o segundo navegador mostra o carrinho vazio e a categoria cacheada, a configuração está correta.

Validação do cache depois de ligarCategoria: primeira chamadaEsperado: missCategoria: segunda chamadaEsperado: hit/carrinho e /pedidoEsperado: nenhum hit/minha-conta e /loginEsperado: nenhum hitDois navegadores com sessãoCarrinho do outro segue vazioPedido de teste completoInclui retorno do gateway

Checklist que você repete em cada loja

Colar no card da tarefa e marcar item por item. Serve igual para a primeira loja e para a décima.

  1. Anotar três medidas de time_starttransfer da URL de categoria, antes de mexer em qualquer coisa.
  2. Copiar as URLs reescritas de cart, order, my-account, history, order-detail, authentication, identity, addresses, address, products-comparison, search e credit-slip, em todos os idiomas ativos.
  3. Ligar o cache de servidor no painel de hospedagem.
  4. Instalar e ativar o módulo de cache conforme a documentação oficial.
  5. Lançar as exclusões por rota e por parâmetro (token=, id_cart=, ajax=, action=, add=, delete=, update=, id_customer=, back=, id_order=, id_order_state=, secure_key=).
  6. Purgar o cache inteiro.
  7. curl -sI em categoria: miss e depois hit.
  8. curl -sI em /carrinho, /pedido, /minha-conta, /login: sem hit.
  9. Teste de dois navegadores com produto no carrinho.
  10. Três medidas de time_starttransfer depois, na mesma URL.
  11. Fechar um pedido de teste de ponta a ponta, incluindo o retorno do gateway de pagamento.
  12. Registrar no documento do cliente a data, a lista de exclusões aplicada e os seis números.

O item 11 é o que mais gente pula e o que mais dá dor de cabeça. Callback de pagamento cacheado quebra confirmação de pedido de um jeito silencioso: o cliente paga e a loja não registra.

O que o cache não resolve: consulta lenta, módulo pesado e checkout

Se o TTFB depois do cache melhorou na categoria mas a loja continua lenta para quem está logado, o cache de página inteira já fez o trabalho dele. O que sobra é consulta pesada, módulo mal escrito ou imagem sem compressão.

Antes de propor plano maior ao cliente, olhe o log de consulta lenta do MySQL e a lista de módulos ativos. Módulo de filtro de camadas, de busca e de cross-selling mal configurados derrubam página de categoria mesmo com cache. Desinstalar um módulo que ninguém usa costuma custar zero e entregar mais que migração.

E o checkout vai continuar no ritmo do servidor, por construção. Essa parte da loja não é cacheável e não deve ser.

Como explicar ao lojista por que o carrinho não entra no cache

Quando o cliente perguntar por que a página de produto ficou instantânea e o carrinho não:

Explicar pela diferença entre página pública e página de sessão costuma convencer mais do que falar de TTFB. O lojista entende o risco, para de pedir "cache em tudo" e passa a tratar a exclusão como proteção, não como limitação.

Se precisar de um argumento extra, mostre as três medidas do antes e as três do depois na categoria. Número da loja dele, não da internet.

Referências

  1. Documentação oficial (litespeed) — LiteSpeed Cache for PrestaShop: Installation. Consultado em 2026-10-02.
Leia também