# Trocar WP Rocket pelo LiteSpeed Cache sem quebrar o site

A sequência de remoção, os pontos que o plugin antigo deixa para trás e como confirmar pelo cabeçalho de resposta que a home passou a ser servida do cache.

> a ordem é limpar o cache pelo plugin antigo, desativar e excluir o plugin (não só desativar), remover o bloco dele do .htaccess, conferir advanced-cache.php e WP_CACHE, e só então ativar o LiteSpeed Cache. A prova é x-litespeed-cache: hit na segunda requisição da home.

João Rizzon · 2026-10-27 · WordPress

---

Trocar de plugin de cache não é desinstalar um e instalar o outro. Os plugins de cache de página no WordPress escrevem fora da própria pasta: colocam um bloco de regras no `.htaccess`, uma constante `WP_CACHE` no `wp-config.php` e arquivos chamados `advanced-cache.php` e `object-cache.php` dentro de `wp-content`. Quando dois plugins mantêm esses arquivos ao mesmo tempo, o servidor tenta servir a mesma URL por dois caminhos diferentes. Daí vêm os três sintomas clássicos: página desatualizada que não some nem com Ctrl+F5, CSS que não carrega (layout "cru"), e erro 500 logo depois de ativar o segundo plugin.

A ordem abaixo segue o que a documentação oficial do LiteSpeed Cache orienta na instalação ([LSCWP Installation](https://docs.litespeedtech.com/lscache/lscwp/installation/)): desativar qualquer outro plugin de cache antes de ativar o LSCWP. O resto do procedimento é limpeza manual do que o plugin antigo deixa para trás.

## Backup e rota de volta antes de editar wp-config e .htaccess

Você vai editar `wp-config.php` e `.htaccess`. Um erro de sintaxe em qualquer um dos dois derruba o site inteiro com erro 500. Então, nesta ordem:

- Faça backup completo (arquivos + banco) pelo painel da hospedagem ou por um plugin de backup. Confirme que o arquivo de backup existe e tem tamanho plausível.
- Baixe uma cópia local de `.htaccess` e de `wp-config.php` pelo Gerenciador de Arquivos ou por FTP. Guarde em uma pasta no seu computador.
- Anote como você acessa o site se o WordPress cair: endereço do painel da hospedagem, usuário de FTP, ou acesso ao Gerenciador de Arquivos.

Se algo quebrar, a reversão é restaurar esses dois arquivos pela cópia local. O site volta ao estado anterior em segundos, sem precisar de restauração de banco.

Um detalhe que economiza dor de cabeça: no Gerenciador de Arquivos do painel, ative a opção de mostrar arquivos ocultos. `.htaccess` começa com ponto e fica invisível por padrão.

## O que o plugin antigo deixa fora da própria pasta

Todos esses plugins mexem nos mesmos quatro arquivos: `.htaccess` e `wp-config.php` na raiz, `advanced-cache.php` e `object-cache.php` dentro de `wp-content`. Além deles, cada plugin mantém uma pasta própria de arquivos de cache, que é o quinto item da tabela. A diferença está no nome do marcador que cada um escreve no `.htaccess` e em quais arquivos de `wp-content` ele cria.

| Onde | WP Rocket | W3 Total Cache | WP Super Cache | LiteSpeed Cache |
|---|---|---|---|---||
| Bloco no `.htaccess` | `# BEGIN WP Rocket` ... `# END WP Rocket` | `# BEGIN W3TC ...` (vários blocos) | `# BEGIN WPSuperCache` ... `# END WPSuperCache` | `# BEGIN LSCACHE` e `# BEGIN NON_LSCACHE` |
| `WP_CACHE` no `wp-config.php` | define como `true` | define como `true` | define como `true` | define como `true` |
| `wp-content/advanced-cache.php` | cria | cria | cria | cria |
| `wp-content/object-cache.php` | cria se usar cache de objeto | cria se usar Redis/Memcached | não cria | cria se você ativar Object Cache |
| Pasta de arquivos de cache | `wp-content/cache/wp-rocket/` | `wp-content/cache/` | `wp-content/cache/` | gerenciado pelo servidor LiteSpeed |

Os blocos e nomes de arquivo acima são os marcadores que você vai procurar. Se o site tiver passado por mais de um plugin ao longo dos anos, é comum encontrar dois ou três blocos órfãos empilhados no mesmo `.htaccess`.

## A ordem de desinstalação que evita erro 500 e layout cru

A desinstalação pelo painel do WordPress costuma limpar o próprio rastro, desde que você use o fluxo completo. Desativar e deixar o plugin instalado não limpa nada.

### Limpe o cache pelo próprio plugin antes de desativar

No WP Rocket, menu **Configurações > WP Rocket**, botão de limpar cache. No W3 Total Cache, barra superior **Performance > Purge All Caches**. No WP Super Cache, **Configurações > WP Super Cache > Excluir Cache**. Isso evita deixar arquivos velhos na pasta `wp-content/cache`.

### Por que desativar sem excluir não limpa nada

Vá em **Plugins > Plugins Instalados**, clique em **Desativar** no plugin antigo e só então em **Excluir**. A exclusão normalmente dispara a rotina de desinstalação, que na maioria dos plugins remove o bloco do `.htaccess` e o `advanced-cache.php`. Nem sempre funciona (depende do plugin e da permissão de escrita nos arquivos), por isso o passo 3 confere na mão. Se você só desativar, a rotina não roda.

### Como saber se advanced-cache.php e object-cache.php são órfãos

Abra o Gerenciador de Arquivos na pasta `wp-content` e procure por `advanced-cache.php` e `object-cache.php`. Se existirem depois da exclusão do plugin antigo, abra cada um e veja a primeira linha: normalmente há um comentário com o nome do plugin que o criou. Arquivo órfão de plugin já excluído pode ser apagado (você tem backup).

Atenção em um caso: se o seu site usa Redis ou Memcached por outro plugin, o `object-cache.php` pode pertencer a ele. Não apague sem confirmar o nome no cabeçalho do arquivo.

Esta limpeza é feita antes de instalar o LiteSpeed Cache. Depois que o LSCWP estiver ativo, ele grava o próprio `advanced-cache.php` em `wp-content` (e o `object-cache.php`, se você ligar o Object Cache). Esses arquivos são do plugin novo e devem ficar onde estão.

### O que fazer com o WP_CACHE enquanto nenhum plugin de cache está ativo

Abra o `wp-config.php` e procure a linha:

```php
define( 'WP_CACHE', true );
```

Com o plugin antigo removido, essa constante fica como `true` sem que exista um `advanced-cache.php` válido em `wp-content`. Enquanto o LiteSpeed Cache não estiver ativo, você pode remover a linha ou trocar `true` por `false`. Qualquer que seja a escolha, mantenha a linha **antes** do comentário `/* That's all, stop editing! */` e preserve ponto e vírgula e aspas.

## Remover o bloco do plugin antigo sem quebrar os permalinks

O `.htaccess` da raiz do WordPress costuma ter, além do cache, regras de redirecionamento, segurança e as regras de permalink do próprio WordPress. Apagar tudo quebra URLs amigáveis.

Abra o arquivo e remova apenas os blocos entre os marcadores do plugin antigo, incluindo as linhas `# BEGIN` e `# END`. Exemplo de bloco órfão que pode ser removido (exemplo ilustrativo, o conteúdo real varia por instalação):

```apache
# BEGIN WPSuperCache
# Regras geradas pelo plugin antigo
# END WPSuperCache
```

Preserve sempre o bloco de permalinks, que fica entre:

```apache
# BEGIN WordPress
# ... regras de rewrite
# END WordPress
```

Depois de salvar, abra o site em uma aba anônima e clique em dois ou três posts internos. Se as URLs amigáveis respondem, o `.htaccess` está íntegro. Se der erro 500, restaure a cópia local e refaça o recorte com mais cuidado.

## Instalar o LiteSpeed Cache e o que ele reescreve sozinho

Com o terreno limpo, vá em **Plugins > Adicionar Novo**, busque por LiteSpeed Cache, instale e ative. A documentação oficial pede que nenhum outro plugin de cache esteja ativo nesse momento, justamente para evitar conflito de regras e de arquivos em `wp-content` ([LSCWP Installation](https://docs.litespeedtech.com/lscache/lscwp/installation/)).

Depois de ativar, entre em **LiteSpeed Cache > Cache** e confirme que a opção de ativar o cache está ligada. Nesse momento o plugin recria o `advanced-cache.php` em `wp-content` e define `WP_CACHE` como `true` no `wp-config.php`: é o comportamento esperado, não mexa nesses dois. O plugin escreve o próprio bloco no `.htaccess`, com os marcadores `# BEGIN LSCACHE` e `# BEGIN NON_LSCACHE`. Reabra o `.htaccess` uma última vez e confirme que agora existe um único conjunto de regras de cache no arquivo.

Um ponto importante sobre expectativa: o cache de página do LiteSpeed Cache depende de o servidor rodar LiteSpeed. Em servidor Apache ou Nginx puro, o plugin ainda serve para otimização (minificação, imagens, cache de objeto), mas o cache de página do servidor não entra em ação e o cabeçalho de hit não aparece.

## A prova de que a home está vindo do cache

A prova de que deu certo é o cabeçalho de resposta `x-litespeed-cache`. Ele tem dois valores que interessam: `miss` na primeira visita, quando a página ainda está sendo gravada, e `hit` nas seguintes, quando o servidor entrega a cópia pronta.

### Ler o cabeçalho x-litespeed-cache pelo DevTools

Abra o site em uma aba anônima (logado no WordPress, o cache de página normalmente é ignorado). Pressione F12, aba **Network**, recarregue a página, clique na primeira linha da lista (o documento HTML) e procure em **Response Headers** por `x-litespeed-cache`. Recarregue mais uma vez e veja se o valor mudou de `miss` para `hit`.

### Ler o cabeçalho x-litespeed-cache com curl -I

Se preferir linha de comando, o comando mais simples mostra só os cabeçalhos:

```bash
curl -I https://seusite.com.br/
```

O `-I` pede apenas os cabeçalhos de resposta. Na saída, procure a linha que começa com `x-litespeed-cache:`. Rode o comando duas vezes seguidas: o esperado é `miss` na primeira e `hit` na segunda.

Se o cabeçalho não aparecer em nenhuma das tentativas, as causas mais comuns são: o servidor não é LiteSpeed, o cache está desligado nas configurações do plugin, ou alguma regra remanescente do plugin antigo continua respondendo antes. Nesse último caso, volte ao `.htaccess` e procure por blocos que você tenha deixado passar.

## Sete itens para conferir antes de considerar a troca concluída

Rode esta lista com o site aberto em aba anônima:

- A home carrega com layout correto, sem CSS faltando.
- Posts internos abrem por URL amigável, sem 404.
- O `.htaccess` tem apenas um bloco de cache, o do LiteSpeed.
- `wp-content` tem apenas o `advanced-cache.php` criado pelo LiteSpeed Cache (confira o nome do plugin na primeira linha do arquivo), sem sobra de plugin já removido.
- `wp-config.php` não declara `WP_CACHE` como `true` sem que exista um `advanced-cache.php` válido em `wp-content`.
- `x-litespeed-cache: hit` aparece na segunda requisição da home.
- Formulário de contato e carrinho (se houver loja) funcionam logado e deslogado.

Se algum item falhar e você não identificar a causa em poucos minutos, restaurar `.htaccess` e `wp-config.php` pela cópia local devolve o site ao estado anterior. A troca pode ser refeita com calma depois, e refazer com o site no ar é sempre melhor que depurar com o site fora.

