# Cache de servidor no Concrete CMS sem quebrar login e formulários

Como instalar o add-on LSCache, quais rotas manter fora do cache para não quebrar login e edição inline, e o comando curl que mostra o ganho na sua própria home.

> ativar o LSCache no Concrete CMS faz o servidor entregar HTML salvo sem executar PHP, o que corta o TTFB da home. Exclua do cache /login, /register, /account, /dashboard, /ccm/ e páginas com formulário, e meça antes e depois com curl -w time_starttransfer.

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

---

Concrete CMS monta cada página no PHP, consulta o banco, resolve blocos, áreas e permissões, e só então entrega o HTML. Para um visitante anônimo que vê exatamente a mesma home que o visitante anterior, esse trabalho todo se repete sem necessidade. Cache de servidor guarda o HTML pronto e devolve o arquivo salvo, sem passar pelo PHP.

O ganho é real, mas o risco também: se o cache guardar a página de um usuário logado e servir para outra pessoa, você vazou sessão. Se ele guardar o retorno de um formulário, o visitante vê a confirmação de alguém. Por isso este guia trata a exclusão de rotas com o mesmo cuidado que a ativação.

## O que o cache de servidor faz e o que ele não faz

Vale separar três camadas que costumam ser confundidas no painel:

| Camada | Onde fica | O que resolve | O que não resolve |
|---|---|---|---||
| Cache interno do Concrete | Dashboard do próprio CMS | Evita reprocessar blocos e consultas repetidas | O PHP ainda roda a cada visita |
| Cache de página no servidor (LSCache) | LiteSpeed/OpenLiteSpeed + add-on | Entrega HTML salvo sem executar PHP | Conteúdo que muda por usuário |
| Cache do navegador | Cabeçalhos HTTP | Repetição de visita do mesmo usuário | O primeiro acesso daquele visitante |
| CDN (borda) | Rede do provedor de CDN | Entrega HTML já salvo na borda para qualquer visitante, inclusive novo | Conteúdo que varia por usuário e o primeiro acesso a cada borda ainda fria |

Este artigo trata da segunda camada. Ela só existe se o seu servidor web for LiteSpeed Enterprise ou OpenLiteSpeed. Se a hospedagem usa Apache ou Nginx puro, o add-on não tem com quem conversar e a aceleração precisa vir por outro caminho (cache de objeto, OPcache, revisão de consultas lentas).

Como verificar em dez segundos, do seu computador:

```
curl -sI https://seudominio.com.br | grep -i server
```

Se a resposta contiver `LiteSpeed`, o caminho descrito aqui se aplica. Se vier `nginx` ou `Apache`, pare por aqui e fale com o suporte da sua hospedagem antes de instalar qualquer coisa.

## Backup e medição do TTFB antes de ativar qualquer coisa

Instalar um add-on de cache mexe em arquivos de configuração do site e pode alterar o `.htaccess`. Faça backup completo (arquivos e banco) antes, pelo painel da hospedagem ou pela ferramenta que você já usa. Se algo quebrar, restaurar o backup é mais rápido do que caçar a linha errada.

Agora meça o estado atual. O número que interessa é o **TTFB**, o tempo até o primeiro byte da resposta, que é justamente o pedaço que o cache encurta. Rode na sua máquina:

```
curl -o /dev/null -s -w "ttfb: %{time_starttransfer}s  total: %{time_total}s\n" https://seudominio.com.br/
```

O comando baixa a home, descarta o conteúdo (`-o /dev/null`), não mostra barra de progresso (`-s`) e imprime dois tempos em segundos. Rode cinco vezes seguidas e anote. A primeira costuma ser maior por causa da resolução de DNS e do handshake TLS; use as seguintes como referência.

Anote também o estado do cabeçalho de cache:

```
curl -sI https://seudominio.com.br/ | grep -i x-litespeed
```

Antes de ativar, essa linha provavelmente não retorna nada. Depois, ela é o seu termômetro.

## Instalar o add-on LSCache no Concrete CMS

A [documentação oficial do LSCache para Concrete CMS](https://docs.litespeedtech.com/lscache/lsccc/installation/) descreve a instalação do add-on e os pré-requisitos de servidor. Siga sempre a página oficial para a versão corrente; o roteiro abaixo serve para você saber o que esperar de cada tela.

### Como saber se o servidor é LiteSpeed ou OpenLiteSpeed

LiteSpeed Enterprise ou OpenLiteSpeed com o módulo de cache habilitado. Em hospedagem compartilhada, quem habilita é o provedor. Em VPS, é você.

### Onde obter o add-on no marketplace do Concrete

No painel, vá em **Dashboard > Extend Concrete**. Procure pelo add-on LSCache e adicione à sua conta. O Concrete permite baixar pela própria interface quando o site está conectado à conta do marketplace; se não estiver, baixe o pacote e envie por FTP para a pasta `packages/` na raiz do site.

### Instalar o pacote e o que fazer se der erro de permissão

Ainda em **Dashboard > Extend Concrete**, o pacote aparece na lista de itens prontos para instalar. Clique em instalar e aguarde. Se a tela retornar erro de permissão, o problema costuma ser dono/permissão da pasta `packages/`, não o add-on.

### Ativar o cache na página de configuração do add-on

O add-on cria sua própria página de configuração dentro do Dashboard. Ative o cache e salve. A partir daqui, o servidor passa a gravar cópias das páginas públicas.

### Confirmar o cabeçalho x-litespeed-cache com curl

```
curl -sI https://seudominio.com.br/ | grep -i x-litespeed-cache
```

A primeira chamada depois de limpar o cache costuma indicar `miss`; a segunda, `hit`. Se nunca sair de `miss`, alguma regra está impedindo o armazenamento, e o lugar de olhar é a lista de exclusões e os cookies que o site define.

## As rotas que precisam ficar fora do cache: login, dashboard e /ccm/

Cache de página só pode guardar o que é igual para todo mundo. Tudo que depende de quem está do outro lado precisa ser excluído. A tabela abaixo é um **exemplo de ponto de partida** para um Concrete CMS padrão, não uma lista oficial: confira os caminhos reais do seu site antes de aplicar, porque instalações com URLs sem `index.php`, com idiomas no caminho ou com add-ons de loja têm rotas próprias.

| Caminho (exemplo) | Por que excluir |
|---|---||
| `/login` | Formulário de autenticação e token de sessão |
| `/register` | Cadastro com token anti-CSRF |
| `/account` | Área pessoal do usuário |
| `/dashboard` | Painel administrativo inteiro |
| `/ccm/` | Chamadas internas do Concrete, incluindo edição inline e AJAX |
| `/index.php/dashboard` | Mesmo painel quando o site não usa URLs amigáveis |
| Página de contato com formulário | Token do formulário fica preso no HTML salvo |
| Página de busca e resultados | Resposta varia por termo pesquisado |
| Carrinho e checkout (se houver add-on de loja) | Conteúdo por sessão |

Dois cuidados que evitam a maior parte dos incidentes:

- **Barrar o cache para usuários logados.** O editor precisa ver a página real para editar inline. Se ele receber HTML salvo, a barra de edição some ou aparece quebrada e o conteúdo salvo não reflete na tela. A exclusão por sessão de usuário logado é a primeira coisa a confirmar na configuração do add-on.
- **Formulários com token.** Qualquer formulário que use token anti-CSRF não sobrevive ao cache: o token fica congelado no HTML e o envio passa a falhar com erro de validação para todo mundo. Se um formulário parou de funcionar logo depois de ligar o cache, a causa é essa, até prova em contrário.

### Onde cadastrar essas exclusões no Dashboard

As exclusões ficam na própria página de configuração do add-on, dentro do Dashboard do Concrete. O caminho é **Dashboard > System & Settings** e, na lista, a entrada criada pelo LSCache (em algumas versões ela aparece agrupada em **Optimization**). Abra essa página e procure, na tela de configuração:

- A chave que liga e desliga o cache de página, que você já marcou no passo anterior.
- O campo de lista de exclusões, um campo de texto de várias linhas em que se cola **um caminho por linha** (`/login`, `/register`, `/account`, `/dashboard`, `/ccm/`). Cole a partir da tabela acima, trocando pelos caminhos reais do seu site.
- A opção de não servir cache para usuário autenticado, normalmente um checkbox com menção a usuário logado ou sessão. Deixe marcada: é ela que protege a edição inline.
- O botão de salvar no fim da página. A configuração só passa a valer depois de salvar, e vale limpar o cache logo em seguida.

Os nomes exatos dos campos mudam de versão para versão do add-on e a documentação oficial não traz uma captura de tela de cada um deles. Se a sua tela estiver diferente do descrito acima, confira a [página oficial do LSCache para Concrete CMS](https://docs.litespeedtech.com/lscache/lsccc/installation/) antes de supor equivalência, e teste cada rota excluída com `curl -sI` depois de salvar.

## Testar o ganho na própria home e conferir uma rota excluída

Com o cache ligado e as exclusões no lugar, repita a medição do início. Rode em sequência, no mesmo computador e na mesma conexão de antes:

```
curl -o /dev/null -s -w "ttfb: %{time_starttransfer}s\n" https://seudominio.com.br/
curl -o /dev/null -s -w "ttfb: %{time_starttransfer}s\n" https://seudominio.com.br/
```

A primeira chamada depois de uma limpeza popula o cache. A segunda já deveria ser servida do arquivo salvo. Compare o TTFB da segunda com a média que você anotou antes de instalar.

Monte uma tabelinha simples das suas medições, assim:

| Cenário | TTFB observado |
|---|---||
| Antes de ligar o cache | preencha |
| Primeira chamada (miss) | preencha |
| Chamada seguinte (hit) | preencha |

A Napoleon Host não mediu este cenário em laboratório, então o número que vale é o seu. Teste também uma rota excluída, por exemplo `/login`, e confirme que ela não retorna `hit`:

```
curl -sI https://seudominio.com.br/login | grep -i x-litespeed-cache
```

O resultado bom aqui é tela vazia: o grep não encontra a linha porque a rota excluída não passa pelo cache. Alguns ambientes devolvem o cabeçalho com uma diretiva de no-cache, e isso também está certo. O único retorno que exige ação é `hit`.

Se essa rota aparecer como `hit`, desative o cache e revise a lista de exclusões antes de deixar o site assim.

## Quando o cache não é a resposta

Cache esconde lentidão, não a corrige. Três situações em que ligar o cache traz pouco e atrasa o diagnóstico de verdade:

- **O site é lento para quem está logado.** Editor, administrador e área restrita não são cacheados por definição. Se a reclamação vem do painel, o caminho é OPcache, cache de objeto, versão do PHP e consultas lentas no banco.
- **O conteúdo muda a cada minuto.** Páginas com contador, estoque em tempo real ou listagem muito dinâmica passam mais tempo invalidando do que servindo.
- **O tempo está indo embora na rede, não no servidor.** Se o `time_total` é muito maior que o `time_starttransfer`, o gargalo é transferência: imagem pesada, JavaScript grande, ausência de compressão. Cache de página não resolve isso.

Antes de trocar de plano, olhe o log de consulta lenta e o tempo de execução do PHP. Em muito site, uma consulta mal indexada ou um add-on abandonado explica a lentidão inteira, e nesse caso o cache só vai mascarar o problema até a próxima página nova.

## Limpeza e rotina depois de publicar

Quando você edita uma página, o HTML salvo precisa ser descartado para o visitante ver a versão nova. O add-on faz isso automaticamente para o conteúdo alterado, mas vale conhecer o botão de limpar tudo na página de configuração: é o primeiro recurso quando alguém diz "publiquei e não aparece".

Rotina mínima que evita susto:

- Publicou mudança grande (tema, cabeçalho, menu): limpe o cache inteiro e recarregue a home em janela anônima.
- Instalou add-on novo que cria página: cheque se a rota dele precisa entrar na lista de exclusões.
- Mudou formulário: envie um teste real, com o navegador deslogado, e confirme que a mensagem de sucesso chega.
- Toda vez que suspeitar de algo, use `curl -sI` na rota suspeita e leia `x-litespeed-cache`. O cabeçalho diz se a página veio do cache ou do PHP, e isso resolve metade das dúvidas sem abrir chamado.

Se precisar voltar atrás, desativar o add-on na página de configuração devolve o site ao comportamento anterior. Restaurar o backup fica para o caso em que o `.htaccess` ou um arquivo de configuração foi alterado e o site não carrega mais.

