blog
WordPress

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.

JR · · 8 min de leitura · 1 tabela · 4 blocos de código

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
  1. Backup e rota de volta antes de editar wp-config e .htaccess
  2. O que o plugin antigo deixa fora da própria pasta
  3. A ordem de desinstalação que evita erro 500 e layout cru
  4. Remover o bloco do plugin antigo sem quebrar os permalinks
  5. Instalar o LiteSpeed Cache e o que ele reescreve sozinho
  6. A prova de que a home está vindo do cache
  7. 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:

  1. 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.
  2. 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.
  3. 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.

Ordem da troca que evita erro 500BackupArquivos, banco e cópia localLimpar cachePelo painel do plugin antigoExcluir pluginDesativar e depois excluirConferir sobrasadvanced-cache, object-cache, WP_CACHEAtivar LSCWPSó com o terreno limpo
Desativar sem excluir não dispara a rotina de limpeza do plugin.

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.

Como confirmar que a home vem do cacheAbrir aba anônimaLogado o cache é ignoradoVer x-litespeed-cacheDevTools Network ou curl -IPrimeira resposta: missPágina sendo gravada agoraSegunda resposta: hitServidor entrega cópia prontaCabeçalho ausenteServidor não LiteSpeed ou bloco órfão
Se o cabeçalho não aparecer nas duas tentativas, revise o .htaccess.

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

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

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

  1. Documentação oficial (litespeed) — LSCWP Installation. Consultado em 2026-10-26.
Leia também