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.

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
- O carrinho de um visitante aparecendo para outro é cache, não invasão
- As rotas e os parâmetros do PrestaShop que nunca podem ser cacheados
- O módulo de cache não liga o cache sozinho
- Meça o time_starttransfer três vezes antes e três depois
- Checklist que você repete em cada loja
- O que o cache não resolve: consulta lenta, módulo pesado e checkout
- 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.
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.
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.
- Anotar três medidas de
time_starttransferda URL de categoria, antes de mexer em qualquer coisa. - Copiar as URLs reescritas de
cart,order,my-account,history,order-detail,authentication,identity,addresses,address,products-comparison,searchecredit-slip, em todos os idiomas ativos. - Ligar o cache de servidor no painel de hospedagem.
- Instalar e ativar o módulo de cache conforme a documentação oficial.
- 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=). - Purgar o cache inteiro.
curl -sIem categoria:misse depoishit.curl -sIem/carrinho,/pedido,/minha-conta,/login: semhit.- Teste de dois navegadores com produto no carrinho.
- Três medidas de
time_starttransferdepois, na mesma URL. - Fechar um pedido de teste de ponta a ponta, incluindo o retorno do gateway de pagamento.
- 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
- Documentação oficial (litespeed) — LiteSpeed Cache for PrestaShop: Installation. Consultado em 2026-10-02.