blog
Infraestrutura web

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.

JR · · 9 min de leitura · 3 tabelas · 6 blocos de código

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
  1. O que o cache de servidor faz e o que ele não faz
  2. Backup e medição do TTFB antes de ativar qualquer coisa
  3. Instalar o add-on LSCache no Concrete CMS
  4. As rotas que precisam ficar fora do cache: login, dashboard e /ccm/
  5. Testar o ganho na própria home e conferir uma rota excluída
  6. Quando o cache não é a resposta
  7. 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.

Ordem segura para ligar o cache de páginaChecar servidorcurl -sI mostra LiteSpeedBackup completoArquivos e banco antes de tudoMedir TTFBCinco chamadas na homeInstalar e ativarAdd-on LSCache no DashboardConfirmar cabeçalhox-litespeed-cache sai de miss
Ordem recomendada: medir antes de ligar o cache, com backup pronto para voltar atrás.

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:

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:

  1. A chave que liga e desliga o cache de página, que você já marcou no passo anterior.
  2. 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.
  3. 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.
  4. 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.

Como ler o cabeçalho e o que fazer depoisRode curl -sI na rotaLeia x-litespeed-cacheRota pública devolveu hitCache funcionando, compare o TTFBRota pública sempre missRevise exclusões e cookies do siteRota de login devolveu hitDesative o cache agoraCorrija a lista de exclusõesLogin, account, dashboard e /ccm/Limpe o cache e repitaTeste rota por rota de novo
O cabeçalho x-litespeed-cache decide o próximo passo. Hit em rota de login é o único caso que exige desligar o cache na hora.

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:

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:

  1. Publicou mudança grande (tema, cabeçalho, menu): limpe o cache inteiro e recarregue a home em janela anônima.
  2. Instalou add-on novo que cria página: cheque se a rota dele precisa entrar na lista de exclusões.
  3. Mudou formulário: envie um teste real, com o navegador deslogado, e confirme que a mensagem de sucesso chega.
  4. 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.

Referências

  1. Documentação oficial (litespeed) — LSCache for Concrete CMS: Installation. Consultado em 2026-10-15.
Leia também