# 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.

> 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.

João Rizzon · 2026-10-03 · Infraestrutura web

---

## 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](https://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:

```bash
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

```bash
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

```bash
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_starttransfer` da 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`, `search` e `credit-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 -sI` em categoria: `miss` e depois `hit`.
- `curl -sI` em `/carrinho`, `/pedido`, `/minha-conta`, `/login`: sem `hit`.
- Teste de dois navegadores com produto no carrinho.
- Três medidas de `time_starttransfer` depois, 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:

> **** "A página do produto é igual para todo mundo, então o servidor guarda uma cópia pronta e entrega na hora. O carrinho e o checkout são diferentes para cada visitante, então precisam ser montados do zero a cada acesso. Se colocássemos o carrinho em cache, um cliente veria o carrinho do outro."

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.

