blog
Infraestrutura web

Cache de servidor no Joomla: 6 rotas fora antes de ligar

Instalação da extensão LiteSpeed Cache for Joomla tela a tela, as rotas que precisam ficar de fora antes de ligar e como você mesmo confere o cabeçalho e mede o antes e o depois.

JR · · 13 min de leitura · 2 tabelas · 15 blocos de código

Resposta curta: o plugin nativo System - Page Cache guarda o HTML, mas ainda sobe o PHP e o Joomla em toda visita. O ganho de TTFB vem do cache de servidor, e ele só é seguro depois que 6 tipos de rota saem do cache. Confira com x-litespeed-cache: hit.

Neste artigo
  1. O que o plugin System - Page Cache economiza, e o que ele não economiza
  2. Por que o cache de servidor responde antes do PHP subir
  3. Backup, linha de base e lista de exclusões antes de instalar qualquer coisa
  4. Instalar a extensão LiteSpeed Cache for Joomla
  5. Configurar as exclusões antes de ligar o cache
  6. Conferir o cabeçalho x-litespeed-cache, miss na primeira carga e hit na segunda
  7. Comparar a mediana de cinco medições antes e depois
  8. O que fazer quando algo quebra, e como voltar atrás

O que o plugin System - Page Cache economiza, e o que ele não economiza

O Joomla vem com um plugin nativo chamado System - Page Cache. Quando você liga esse plugin, o Joomla passa a guardar o HTML já montado de cada página dentro da pasta cache/ do site e a reaproveitar esse HTML nas visitas seguintes.

O detalhe que muda tudo: para reaproveitar, o Joomla precisa rodar.

A cada visita, mesmo com o cache nativo ligado, a sequência é a mesma. O servidor web recebe a requisição, aciona o PHP, o PHP carrega o framework do Joomla, o framework lê a configuração, abre conexão com o banco, decide qual é a página, descobre que existe um arquivo de cache correspondente, lê esse arquivo do disco e devolve o conteúdo. O que o cache nativo economiza é a parte cara do meio (consultar os artigos, montar os módulos, renderizar o template). O que ele não economiza é o boot do PHP e do Joomla, que acontece em toda requisição.

Por isso é comum o dono do site ligar o Page Cache, olhar o tempo de resposta e achar que "não mudou nada". Mudou alguma coisa, só que o piso continua sendo o custo de subir a aplicação.

Por que o cache de servidor responde antes do PHP subir

Cache de servidor é outra camada. Ele fica antes do PHP.

Com o LiteSpeed Cache ativo e uma página guardada, o servidor recebe a requisição, encontra a cópia dessa URL no cache dele e responde direto, sem chamar o PHP e sem tocar no banco. O Joomla nem fica sabendo que houve uma visita. É esse salto (aplicação inteira fora do caminho) que costuma aparecer no tempo até o primeiro byte.

A extensão LiteSpeed Cache for Joomla não é quem guarda a página. Ela é quem conversa com o servidor: diz "esta resposta pode ser guardada", diz "esta aqui não pode" e diz "apague o que está guardado" quando você salva um artigo. Quem guarda e quem entrega é o servidor LiteSpeed. A página oficial de instalação da LiteSpeed lista os requisitos de servidor para que isso funcione: é preciso estar em LiteSpeed Web Server (Enterprise ou OpenLiteSpeed) com o módulo de cache habilitado. Se a sua hospedagem roda Apache ou Nginx puros, instalar a extensão não vai gerar cache de servidor.

Antes de qualquer coisa, confirme com seu provedor (ou olhe o cabeçalho server da resposta, mostrado mais adiante) se o seu site está mesmo em LiteSpeed.

Camada Onde roda O que economiza Como limpar
System - Page Cache (nativo do Joomla) Dentro do PHP, a cada visita A montagem da página (consultas, módulos, template) Sistema, Limpar cache, no painel do Joomla
LiteSpeed Cache (servidor) No servidor web, antes do PHP O PHP inteiro, incluindo o boot do Joomla e o banco Botão de purge da extensão, ou purge automático ao salvar conteúdo
CDN na frente do site Fora do seu servidor A viagem de rede até o seu datacenter Painel do CDN

As três podem coexistir, mas cada camada nova é mais um lugar onde uma página velha pode ficar presa. Comece com uma.

Backup, linha de base e lista de exclusões antes de instalar qualquer coisa

Instalar extensão em Joomla mexe no banco e no sistema de arquivos. Faça backup completo (arquivos e banco) antes, pelo painel da hospedagem ou por uma ferramenta de backup do próprio Joomla. Sem backup, o plano B vira "refazer o site".

Meça o TTFB agora, com o cache ainda desligado

Esta é a hora de medir o "antes". Depois que o cache estiver ligado e a home guardada, não existe mais como reproduzir o estado original sem desligar tudo de novo.

Abra o terminal no seu computador (Terminal no macOS e Linux, Prompt de Comando ou PowerShell no Windows) e rode o comando abaixo cinco vezes seguidas, anotando os cinco valores:

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

No Prompt de Comando do Windows, troque o destino do descarte por NUL:

curl -o NUL -s -w "TTFB: %{time_starttransfer}s\n" https://seusite.com.br/

No PowerShell, use curl.exe (sem o .exe, o PowerShell pode interpretar curl como apelido de outro comando) e aspas simples ao redor do formato:

curl.exe -o NUL -s -w 'TTFB: %{time_starttransfer}s\n' https://seusite.com.br/

Linha a linha: -o /dev/null (ou -o NUL) descarta o HTML, -s esconde a barra de progresso e -w imprime a variável time_starttransfer, que é o tempo desde o início da requisição até o primeiro byte do corpo da resposta chegar (inclui DNS, conexão e TLS). A saída é uma linha por execução, no formato TTFB: 0.412000s.

Guarde esses cinco números em um bloco de notas com a data, a hora e de onde você mediu (casa, escritório, 4G). A comparação do fim do artigo depende deles.

Se você chegou neste artigo com o cache já ligado e quer a linha de base mesmo assim, é possível: desligue o cache nas opções da extensão, purgue tudo, espere um minuto e só então rode as cinco medições. Depois religue.

As 6 rotas que precisam ficar fora do cache

O risco real do cache de servidor não é o site cair. É o servidor guardar uma página que deveria ser única por visitante e entregar essa mesma página para outra pessoa. Um carrinho de compras cacheado é um carrinho errado para todo mundo.

Monte a lista de rotas problemáticas do seu site antes de ligar o cache. Navegue pelo site e anote a URL que aparece na barra de endereço em cada uma dessas situações:

Rota Por que não pode ser cacheada
/administrator e tudo abaixo dele Área logada, conteúdo depende do usuário
Formulário de contato (componente Contatos ou extensão de formulário) Token anti-CSRF dentro do HTML; cacheado, o envio passa a falhar
Carrinho e checkout (VirtueMart, HikaShop) Estado por sessão, valores e itens por visitante
Resultado de busca interna URL com termo variável, gera cache infinito e inútil
Área de membros, login e perfil do usuário Conteúdo por usuário
Qualquer página que gere um PDF, boleto ou download único Resposta é dinâmica por definição

De quebra, teste depois se páginas com paginação, filtros e ordenação estão devolvendo o conteúdo certo. Esses são os lugares onde "deu certo na home" não prova nada.

Instalar a extensão LiteSpeed Cache for Joomla

Os nomes de menu abaixo seguem o Joomla 4 e 5. No Joomla 3, o caminho equivalente começa em Extensões, não em Sistema.

Confirme que o servidor é LiteSpeed antes de instalar

No macOS e no Linux, abra o Terminal e rode:

curl -sI https://seusite.com.br/ | grep -i "^server:"

-s deixa a saída limpa, -I pede só os cabeçalhos e o grep -i filtra a linha do servidor sem diferenciar maiúsculas.

O Prompt de Comando do Windows não tem grep. Se você colar a linha acima ali, recebe "não é reconhecido como um comando interno ou externo". A versão equivalente usa o findstr:

curl -sI https://seusite.com.br/ | findstr /i "server:"

No PowerShell, chame o curl.exe e filtre com Select-String:

curl.exe -sI https://seusite.com.br/ | Select-String -Pattern "server:"

Nas três formas a saída é uma linha só, parecida com server: LiteSpeed. A resposta esperada contém a palavra LiteSpeed. Se vier Apache ou nginx, pare aqui e fale com o suporte da hospedagem: a extensão não vai ter com quem conversar. Se não sair linha nenhuma, rode o comando sem o filtro (curl -sI https://seusite.com.br/) e leia os cabeçalhos com o olho.

Baixe o pacote ou use o Instalar pela Web

A documentação oficial descreve dois caminhos. O primeiro é o catálogo dentro do próprio Joomla: Sistema, Instalar, Extensões, aba Instalar pela Web, e busque por LSCache. O segundo é baixar o pacote .zip no site da LiteSpeed e usar a aba Fazer Upload do Arquivo de Pacote, arrastando o zip para a área indicada.

Se a aba "Instalar pela Web" estiver desabilitada no seu Joomla, use o upload do zip. Dá no mesmo.

Habilite o plugin do tipo System (instalado não é ativo)

O pacote instala um componente e pelo menos um plugin. Instalado não é o mesmo que ativo.

Vá em Sistema, Plugins, digite litespeed no campo de busca e confira o status de tudo que aparecer. O plugin do tipo System precisa estar Habilitado. Se estiver desabilitado, clique no ícone de status ou selecione a linha e use o botão Ações, Habilitar.

Abra o painel da extensão sem ligar o cache ainda

Em Componentes, procure a entrada do LiteSpeed Cache. Abra as opções e resista à vontade de salvar com tudo ligado. A ordem que evita dor de cabeça é: primeiro as exclusões, depois o cache.

Configurar as exclusões antes de ligar o cache

Dentro das opções da extensão existem campos para listar URLs que não devem ser cacheadas. Os rótulos variam conforme a versão do pacote, mas a lógica é sempre a mesma: uma URL ou um trecho de URL por linha.

Cole ali a lista que você montou na seção anterior. Um exemplo ilustrativo de como essas linhas costumam ficar (troque pelos caminhos reais do seu site, os nomes abaixo são exemplo e não configuração pronta):

/administrator
/index.php?option=com_search
/index.php?option=com_virtuemart&view=cart
/carrinho
/contato
/minha-conta

Três cuidados que economizam retrabalho:

Sobre o TTL (o tempo que cada página fica guardada), comece conservador. Um valor baixo significa mais visitas chegando no PHP, o que é ruim para desempenho e ótimo para descobrir que uma exclusão ficou faltando. Você aumenta depois, quando o site estiver estável.

Conferir o cabeçalho x-litespeed-cache, miss na primeira carga e hit na segunda

O sinal de que o cache de servidor entrou em ação é um cabeçalho de resposta chamado x-litespeed-cache. Ele aparece com valor miss quando a resposta foi montada na hora pelo PHP e com valor hit quando o servidor entregou a cópia guardada.

Ver o cabeçalho no DevTools, em janela anônima

  1. Abra a home do site em uma janela anônima (sessão do Joomla logada costuma fazer o servidor pular o cache, e aí você testa a coisa errada).
  2. Pressione F12 para abrir o DevTools e vá na aba Network (ou Rede).
  3. Recarregue a página com Ctrl+F5 (Cmd+Shift+R no macOS).
  4. Na lista de requisições, clique na primeira linha, a do documento HTML (o nome costuma ser o domínio ou /).
  5. Abra Headers, role até Response Headers e procure x-litespeed-cache.
  6. Recarregue mais uma vez e olhe de novo.

O comportamento esperado é miss na primeira carga e hit na segunda. Se as duas derem miss, o servidor não está guardando a página. Se você não achar o cabeçalho nenhuma vez, ou o módulo de cache não está habilitado para o seu domínio, ou o plugin do sistema ficou desabilitado no passo 3.

Ver o cabeçalho pelo terminal no macOS, Linux e Windows

macOS e Linux:

curl -sI https://seusite.com.br/ | grep -i "x-litespeed"

Prompt de Comando do Windows:

curl -sI https://seusite.com.br/ | findstr /i "x-litespeed"

PowerShell:

curl.exe -sI https://seusite.com.br/ | Select-String -Pattern "x-litespeed"

Rode duas vezes seguidas. O curl não carrega cookies do seu navegador, então ele sempre se apresenta como visitante anônimo, que é exatamente o caso que interessa.

Exemplo ilustrativo de saída na segunda execução (leitura de tela de exemplo, não medição nossa):

x-litespeed-cache: hit

Se o filtro não devolver nada em nenhuma das duas execuções, rode curl -sI https://seusite.com.br/ puro e leia a lista inteira de cabeçalhos: pode ser que o cabeçalho não exista mesmo, e aí o problema é de configuração, não do filtro.

Agora repita o mesmo comando em uma rota que você excluiu, trocando só a URL:

curl -sI https://seusite.com.br/contato | grep -i "x-litespeed"
curl -sI https://seusite.com.br/contato | findstr /i "x-litespeed"

Aqui o esperado é o oposto: nunca dar hit, por mais que você repita. Se der hit em página de formulário, carrinho ou área logada, desligue o cache e revise a lista de exclusões antes de qualquer outra coisa.

Comparar a mediana de cinco medições antes e depois

Não adianta confiar na sensação de que "ficou mais rápido". Meça, e meça a coisa certa: o tempo até o primeiro byte, que é onde o cache de servidor age. Imagem, fonte e JavaScript não entram nessa conta.

A sequência completa, na ordem em que precisa acontecer:

  1. Medir com o cache desligado (foi o que você fez lá na seção de preparação, antes de instalar qualquer coisa). Cinco execuções, cinco valores anotados.
  2. Ligar o cache e visitar a home uma vez, para que ela seja guardada.
  3. Confirmar x-litespeed-cache: hit com o comando da seção anterior. Sem essa confirmação, a segunda medição não mede o cache, mede outra coisa.
  4. Medir de novo, cinco execuções, no mesmo horário aproximado, da mesma máquina e da mesma conexão da primeira rodada.
  5. Comparar a mediana dos cinco valores de cada rodada, não o melhor valor de cada uma.

Se você pulou a medição inicial, não invente um "antes": desligue o cache nas opções da extensão, purgue tudo, rode as cinco medições, religue o cache, confirme o hit e rode as outras cinco. Dá o mesmo resultado, com o custo de alguns minutos com o site sem cache.

O comando da medição é o mesmo da seção de preparação:

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

No Prompt de Comando do Windows, -o NUL no lugar de -o /dev/null. No PowerShell, curl.exe e aspas simples no -w.

Exemplo ilustrativo de como a saída se parece (valores de exemplo, não resultado medido por nós):

TTFB: 0.412000s
TTFB: 0.398000s

Se você está longe do servidor, boa parte desse tempo é rede e não muda com cache nenhum. Por isso a comparação só vale contra você mesmo, na mesma máquina e na mesma conexão. Um teste rodado do celular na quarta e do notebook no sábado não compara nada.

O que fazer quando algo quebra, e como voltar atrás

Página velha aparecendo depois de editar um artigo

Primeiro purgue pela extensão (o painel do componente tem a ação de limpar tudo). Se o conteúdo novo aparece depois do purge, o problema é o gatilho automático de purge ao salvar, não o cache em si. Enquanto investiga, reduza o TTL.

Se mesmo depois do purge a página velha continua, o suspeito é outra camada: o cache nativo do Joomla em Sistema, Limpar cache, ou o CDN, se houver.

Formulário de contato parou de enviar

Clássico de token cacheado. Adicione a rota do formulário às exclusões, purgue tudo e teste de novo em janela anônima.

Usuário logado vendo conteúdo de visitante

Desligue o cache imediatamente pelo painel da extensão. Isso não desinstala nada e devolve o site ao comportamento anterior em segundos. Revise as exclusões e a configuração de cache para usuários logados antes de religar.

Rollback completo, do menos invasivo ao mais invasivo

A ordem de desmonte, do menos invasivo para o mais invasivo:

  1. Desligue o cache nas opções da extensão e purgue.
  2. Desabilite o plugin do sistema em Sistema, Plugins.
  3. Se ainda assim o site estiver estranho, desinstale o pacote em Sistema, Gerenciar, Extensões.
  4. Se algo saiu do lugar no banco, restaure o backup que você fez antes de começar.

Manter ou desligar o plugin nativo depois do cache de servidor

Depois que o cache de servidor estiver estável e você tiver confirmado hit nas páginas públicas, manter o System - Page Cache ligado deixa de fazer muita diferença para o visitante anônimo: essas visitas nem chegam ao PHP. O que sobra são duas camadas com TTLs distintos e dois lugares para uma página velha se esconder. Desligar o nativo simplifica o diagnóstico. Se você desligar e notar piora nas rotas que ficaram fora do cache de servidor (as excluídas), religue, porque ali o cache de aplicação ainda trabalha.

E vale dizer o contrário do que se espera de quem vende hospedagem: se o seu TTFB continua alto mesmo com x-litespeed-cache: hit confirmado, o gargalo não é PHP nem plano. É rede, TLS, redirecionamento em cadeia ou algo na frente do servidor. Trocar de plano não resolve esse caso, e o teste acima é o que separa um cenário do outro.

---

Fonte consultada: LSCache for Joomla, Installation (documentação oficial LiteSpeed), consultada em 24/09/2026. Os caminhos de menu descritos seguem o Joomla 4 e 5. Nenhum número de tempo neste artigo é medição da Napoleon Host: os valores mostrados são exemplos de leitura de tela, e a medição válida é a que você roda no seu próprio site com os comandos acima.

Referências

  1. Documentação oficial (litespeed) — LSCache for Joomla: Installation. Consultado em 2026-09-24.
Leia também