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

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

João Rizzon · 2026-09-24 · Infraestrutura web

---

## 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](https://docs.litespeedtech.com/lscache/lscjoomla/installation/) 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:

- **Use o caminho como ele aparece na barra de endereço.** Se o seu site usa URLs amigáveis, a rota é `/contato`, não `index.php?option=com_contact`. Se usa as duas formas, liste as duas.
- **Confira o comportamento com usuário logado.** Visitante anônimo e usuário logado precisam receber páginas diferentes. Depois de ligar o cache, faça o teste do jeito mais simples: abra o site logado em uma janela normal e deslogado em uma janela anônima, na mesma página, e veja se o módulo de login mostra o estado certo em cada uma.
- **Só então salve e ative o cache.** Assim a primeira página guardada já nasce dentro das regras.

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

- 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).
- Pressione F12 para abrir o DevTools e vá na aba **Network** (ou **Rede**).
- Recarregue a página com Ctrl+F5 (Cmd+Shift+R no macOS).
- Na lista de requisições, clique na primeira linha, a do documento HTML (o nome costuma ser o domínio ou `/`).
- Abra **Headers**, role até **Response Headers** e procure `x-litespeed-cache`.
- 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:

- **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.
- **Ligar o cache** e visitar a home uma vez, para que ela seja guardada.
- **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.
- **Medir de novo**, cinco execuções, no mesmo horário aproximado, da mesma máquina e da mesma conexão da primeira rodada.
- **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:

- Desligue o cache nas opções da extensão e purgue.
- Desabilite o plugin do sistema em **Sistema, Plugins**.
- Se ainda assim o site estiver estranho, desinstale o pacote em **Sistema, Gerenciar, Extensões**.
- 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)](https://docs.litespeedtech.com/lscache/lscjoomla/installation/), 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.

