Redis: plugin, vários sites e solução de problemas
Indo além do básico: bancos separados, limpeza do cache e erros de conexão
Portal Web
Última atualização há 22 dias
O tutorial Ativar o Redis mostra o caminho básico: ligar o Redis no painel e conectar o WordPress pelo LiteSpeed Cache. Este aqui é para quando você precisa ir além: usar outro plugin, manter vários sites sem misturar os dados, limpar o cache e resolver problemas de conexão.
Como o Redis funciona na sua conta
- A conta tem um único Redis, que se conecta por um arquivo de soquete (algo como /home/seuusuario/.redis/redis.sock), e não por uma porta de rede. O caminho aparece na tela Cache Redis do painel.
- Ele guarda só cache: dados que o site consegue refazer. Se o Redis reiniciar ou for limpo, o site continua funcionando, apenas um pouco mais devagar até o cache encher de novo. Nunca use o Redis para guardar informação que você não possa perder.
- Todos os sites da conta usam o mesmo Redis. Para os dados não se misturarem, cada site precisa de um número de banco (database) próprio e, de preferência, de um prefixo próprio.
Vários sites na mesma conta
Dê um número diferente para cada WordPress: 0 para o primeiro, 1 para o segundo, 2 para o terceiro e assim por diante. No LiteSpeed Cache, o campo é o Redis Database ID. Anote em uma lista qual número é de qual site, porque dois sites no mesmo número se misturam e podem mostrar conteúdo trocado.
Usar o plugin Redis Object Cache
Se preferir um plugin de Redis em vez do LiteSpeed Cache, use um ou outro, nunca os dois ao mesmo tempo (eles brigam pelo mesmo arquivo de cache). Desligue o Object Cache do LiteSpeed Cache antes de ativar o plugin. No plugin Redis Object Cache, as configurações vão no arquivo wp-config.php, antes da linha que diz "That's all, stop editing":
- WP_REDIS_SCHEME = unix
- WP_REDIS_PATH = o caminho do soquete que aparece no painel
- WP_REDIS_DATABASE = o número do banco deste site
- WP_REDIS_PREFIX = um texto curto e único para este site (por exemplo, o nome do site)
Depois, no painel do WordPress, abra Configurações > Redis e clique em Ativar cache de objetos. A página mostra se está conectado. Antes de editar o wp-config.php, faça uma cópia do arquivo: um erro nele derruba o site. Veja Gerenciador de Arquivos.
Limpar o cache de objetos
Limpe o cache quando mudar dados direto no banco, trocar o endereço do site ou notar que uma informação antiga não sai. No LiteSpeed Cache, use a opção de limpar o cache de objetos (Purge). No plugin Redis Object Cache, use Flush Cache. Limpar é seguro: o cache é refeito sozinho.
Problemas comuns
- "Error establishing a Redis connection" ou status "Not connected": confira se o Redis está ativo na tela Cache Redis do painel, se o caminho do soquete está igual ao da tela (sem erro de digitação) e se não sobrou um plugin antigo de cache de objetos.
- Desativei o Redis no painel e o site deu erro: o WordPress ainda tenta falar com ele. Pelo Gerenciador de Arquivos, abra a pasta wp-content e renomeie o arquivo object-cache.php para object-cache.php.off. O site volta e o cache de objetos fica desligado. Depois, ajuste o plugin com calma. Antes de desativar o Redis no painel, desligue o Object Cache no WordPress.
- Dois sites mostram dados trocados: estão usando o mesmo número de banco. Troque o de um deles e limpe o cache dos dois.
- O painel do WordPress ficou lento depois de ligar o Redis: desligue o cache de objetos para testar. Em sites pequenos e já com cache de páginas, o ganho é pequeno. Veja Site lento: diagnóstico básico e LiteSpeed Cache no WordPress.
- Tela branca ou erro 500 logo depois de mexer no Redis: volte a configuração anterior e veja Tela branca no WordPress e o log de erros.
Veja também