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.

Resposta curta: 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.
Neste artigo
- Backup e rota de volta antes de editar wp-config e .htaccess
- O que o plugin antigo deixa fora da própria pasta
- A ordem de desinstalação que evita erro 500 e layout cru
- Remover o bloco do plugin antigo sem quebrar os permalinks
- Instalar o LiteSpeed Cache e o que ele reescreve sozinho
- A prova de que a home está vindo do cache
- Sete itens para conferir antes de considerar a troca concluída
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): 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
.htaccesse dewp-config.phppelo 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:
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):
# BEGIN WPSuperCache
# Regras geradas pelo plugin antigo
# END WPSuperCache
Preserve sempre o bloco de permalinks, que fica entre:
# 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).
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:
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
.htaccesstem apenas um bloco de cache, o do LiteSpeed. wp-contenttem apenas oadvanced-cache.phpcriado pelo LiteSpeed Cache (confira o nome do plugin na primeira linha do arquivo), sem sobra de plugin já removido.wp-config.phpnão declaraWP_CACHEcomotruesem que exista umadvanced-cache.phpválido emwp-content.x-litespeed-cache: hitaparece 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.
Referências
- Documentação oficial (litespeed) — LSCWP Installation. Consultado em 2026-10-26.