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.

Resposta curta: 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.
Neste artigo
- O que o cache de servidor faz e o que ele não faz
- Backup e medição do TTFB antes de ativar qualquer coisa
- Instalar o add-on LSCache no Concrete CMS
- As rotas que precisam ficar fora do cache: login, dashboard e /ccm/
- Testar o ganho na própria home e conferir uma rota excluída
- Quando o cache não é a resposta
- Limpeza e rotina depois de publicar
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 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 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 otime_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 -sIna rota suspeita e leiax-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.
Referências
- Documentação oficial (litespeed) — LSCache for Concrete CMS: Installation. Consultado em 2026-10-15.