Faz edições a um tema, altera texto numa página, atualiza um plugin e o site parece não ter mudado nada. Parece-lhe familiar? Quase de certeza que se deparou com a cache do WordPress. E não, isto não é um bug e não é preciso reiniciar o servidor.

A cache é uma coisa útil. Acelera o carregamento das páginas várias vezes, poupa recursos de alojamento e melhora as métricas de comportamento. Mas só até começar a mostrar uma versão desatualizada do site a si e aos seus visitantes. Aí, a cache deixa de ser uma ajuda e passa a ser um problema.

Boas notícias: limpar a cache do WordPress demora segundos. Sem consola, sem programador, sem encantamentos mágicos. Neste guia, todos os quatro tipos de cache que existem em qualquer site WordPress, mais instruções passo a passo para limpar cada um. Do navegador à CDN.

💡 Visão geral rápida:

• Abra o seu navegador, prima Ctrl+Shift+Del e já vai a meio do caminho para limpar a cache do navegador
• No painel de administração do WordPress, clique num botão no plugin de cache e ele limpa a cache do plugin num segundo
• Se o seu site está num alojamento gerido (WP Engine, Flywheel, Cloudways), o painel de alojamento tem um botão nativo para reiniciar a cache do servidor
• Para sites protegidos pelo Cloudflare ou Sucuri, a limpeza é feita através do painel do fornecedor de CDN, também com um clique

O que é a cache do WordPress

A cache é um armazenamento temporário de dados. Em vez de construir uma página de raiz a cada pedido (PHP + base de dados + ficheiros do tema), o servidor ou o navegador entrega uma cópia já preparada e guardada. O resultado: a página carrega não em 2 segundos, mas em 0,4.

Uma analogia do dia a dia: mudou o comando da televisão do armário para o sofá. Da próxima vez, não precisa de se levantar e atravessar a sala, o comando já está à mão. A cache funciona da mesma forma: os dados «quentes» são armazenados por perto, o acesso a eles é instantâneo.

No ecossistema WordPress, o caching acontece a vários níveis em simultâneo. E para perceber qual a cache específica que o está a impedir de ver a versão atualizada do site, precisa de conhecer estes níveis de cor.

4 Tipos de cache num site WordPress

Todos os sites WordPress, independentemente do alojamento e da configuração de plugins, passam por quatro camadas de caching. Vamos analisar cada uma.

Cache do navegador

Qualquer navegador moderno (Chrome, Firefox, Edge, Safari) guarda automaticamente conteúdo estático dos sites visitados no seu computador: imagens, ficheiros CSS, JavaScript, tipos de letra e até páginas HTML inteiras. Ao revisitar um site, o navegador não descarrega estes ficheiros novamente, mas vai buscá-los ao armazenamento local.

Para o proprietário do site, isto é uma vantagem: os visitantes habituais veem as páginas mais rápido, a carga do servidor diminui. O inconveniente surge quando atualizou o seu logótipo, mudou a cor dos botões ou alterou os tipos de letra, mas o seu navegador continua a mostrar versões antigas dos ficheiros. A solução: limpeza manual da cache do navegador (instruções abaixo).

Cache de plugins

Os plugins de caching são a principal ferramenta para acelerar o WordPress. Criam cópias HTML estáticas das páginas dinâmicas e servem-nas aos visitantes, contornando o ciclo pesado de PHP+MySQL. As duas soluções gratuitas mais populares são o W3 Total Cache no WordPress.org (mais de 1 milhão de instalações ativas) e o WP Super Cache da Automattic (mais de 1 milhão de instalações ativas, desenvolvido pela Automattic).

Um plugin pode fazer cache de páginas, CSS/JS comprimidos, consultas à base de dados, objetos e até integrar-se com uma CDN. Mas se os visitantes veem a versão antiga depois de publicar um novo artigo ou editar o design, o culpado é quase de certeza a cache do plugin. O botão «Eliminar Cache» no painel de administração resolve o problema instantaneamente.

Cache do servidor

A maioria dos alojamentos WordPress geridos incorpora o caching de servidor diretamente na sua arquitetura. O WP Engine adiciona um botão para limpar diretamente no painel de administração do WordPress. O Flywheel coloca-o na barra superior. O Pagely usa o seu próprio painel PressArmor com uma opção Purge All.

Alguns alojamentos vão mais longe e usam um proxy reverso: vários servidores de cache ficam «à frente» do servidor principal e tratam dos pedidos repetidos. A cache do servidor é limpa através do painel de alojamento ou contactando o suporte; não há aqui um botão universal, cada alojamento implementa-o de forma diferente.

Cache de terceiros (CDN)

Se o site for encaminhado através de um fornecedor de CDN (Cloudflare ou Sucuri), surge outra camada de cache, distribuída por dezenas de centros de dados em todo o mundo. A CDN armazena cópias de ficheiros estáticos e até de páginas HTML inteiras geograficamente próximas de cada visitante.

Facto interessante: uma CDN bem configurada pode servir o conteúdo estático de um site mesmo que o servidor de origem esteja temporariamente indisponível. Os visitantes não dão por isso, as páginas continuam a abrir a partir da cache. Mas o preço desta conveniência é a necessidade de limpar a cache da CDN a cada atualização significativa do site. Caso contrário, visitantes de regiões diferentes verão versões diferentes das páginas.

Porquê limpar a cache do WordPress

A cache faz o seu trabalho na perfeição quase sempre. Mas há três situações específicas em que precisa de a limpar imediatamente:

Atualizou conteúdo, mas não vê as alterações. Reescreveu um título, substituiu texto na página inicial, adicionou um novo bloco, clicou em «Atualizar» no painel de administração, mas o site mostra a versão antiga. É a cache do plugin ou do servidor a reter a cópia antiga.

O design partiu-se após edições. Alterou o CSS, atualizou o tema, instalou um novo plugin e o layout ficou desconfigurado. Muitas vezes, o problema não está no código, mas no navegador, que continua a carregar estilos e scripts antigos. Limpar a cache do navegador e limpar a cache do plugin em conjunto resolve a maioria destes casos.

Os visitantes veem conteúdo desatualizado. Uma cache mal configurada pode mostrar uma versão antiga da página durante semanas a utilizadores que já visitaram o site. A cache da CDN é especialmente traiçoeira: um visitante de Berlim vê uma coisa, enquanto alguém de Tóquio vê outra. Limpar todas as camadas de cache sincroniza o resultado.

Como limpar a cache do navegador

A cache do navegador é a mais simples de limpar e a razão mais comum pela qual os proprietários de sites não veem as suas próprias edições. Vamos abordar três navegadores principais.

Google Chrome

O Chrome faz cache de forma agressiva; esta é uma das razões para a sua velocidade. Mas a limpeza demora apenas três cliques.

Clique no ícone de três pontos no canto superior direito, vá a Mais ferramentas e selecione Limpar dados de navegação. O atalho de teclado Ctrl+Shift+Del faz o mesmo.

Na janela que se abre, selecione o intervalo de tempo (recomendo «Todo o período» para uma limpeza completa), marque Imagens e ficheiros em cache e clique em Limpar dados.

Pronto. Recarregue a página do site com Ctrl+F5 (atualização forçada sem cache) e verá a versão atual.

Mozilla Firefox

O Firefox iguala o Chrome em conveniência na limpeza de cache. Clique no ícone do menu (três linhas) e, em seguida, no separador Histórico.

No painel suspenso, selecione Limpar histórico recente.

Na janela que aparece, defina o intervalo de tempo como «Tudo», marque Cache e clique em Limpar agora.

Microsoft Edge

O Edge é construído sobre o mesmo motor Chromium do Chrome, por isso a lógica de limpeza é semelhante. Clique no ícone do menu (três pontos) e selecione Definições.

No menu de definições à esquerda, vá a Privacidade, pesquisa e serviços e clique no botão Escolher o que limpar.

Marque Imagens e ficheiros em cache e clique em Limpar agora.

Uma funcionalidade útil do Edge que o Chrome não tem: pode ativar a limpeza automática da cache sempre que o navegador é fechado. Encontra-se na mesma secção de definições de privacidade.

Depois de limpar a cache do navegador, abra o site usando Ctrl+F5. Se o problema persistir, passe para a cache de plugins.

Como limpar a cache dos plugins

O método de limpeza depende do plugin específico, mas quase sempre se resume a premir um botão na administração do WordPress.

W3 Total Cache

O W3 Total Cache no repositório é o plugin gratuito mais rico em funcionalidades para cache no WordPress. Faz cache de páginas, objetos, consultas à base de dados, comprime CSS e JS e integra-se com CDN. É usado em sites como a AT&T e o MakeUseOf.

Para limpar a cache, vá à administração do WordPress e navegue até Performance → Dashboard. Clique no botão empty all caches e o plugin irá limpar todas as camadas de cache numa só operação.

WP Super Cache

O WP Super Cache no WordPress.org é desenvolvido pela Automattic, a empresa por detrás do WordPress.com, Jetpack, Akismet e WooCommerce. O plugin gera ficheiros HTML estáticos a partir de conteúdo dinâmico e serve-os em vez do pesado ciclo PHP.

A limpeza é simples: na administração do WordPress, vá a Settings → WP Super Cache e clique no botão Delete Cache.

Ambos os plugins também adicionam um botão de limpeza rápida à barra de administração do WordPress, permitindo-lhe limpar a cache com um clique a partir de qualquer secção da administração.

Como limpar a cache do servidor e de terceiros

Para a cache do servidor, não há uma instrução universal; cada fornecedor de alojamento implementa o mecanismo de forma diferente. O princípio geral: em alojamentos WordPress geridos (WP Engine, Flywheel, Cloudways, Kinsta), o botão de limpeza de cache está integrado no painel de controlo do alojamento ou diretamente na administração do WordPress. Em alojamentos partilhados (SiteGround, Bluehost), a função de cache pode estar na secção «Site Optimization» do cPanel.

Para limpar a cache da Cloudflare, inicie sessão na sua conta, selecione o site e vá a Caching → Purge Cache. O botão Purge Everything limpa toda a cache da CDN para o domínio. A Sucuri tem um caminho semelhante: Performance → Clear Cache. Ambas as operações demoram entre 30 segundos a 2 minutos, enquanto a CDN envia o comando de limpeza para todos os centros de dados.

Se o site usar cache de servidor e CDN, a ordem é importante: limpe primeiro a cache do servidor e depois a cache da CDN. Isto garante que a CDN guarda em cache a versão atualizada do servidor, e não uma cópia antiga.

Um pequeno vídeo sobre o tema: análise de todos os tipos de cache no WordPress, incluindo Redis Object Cache e Full Page Cache, com uma demonstração de como limpar cada camada.

⁉️🤔 Perguntas frequentes

Por que não vejo as alterações no site depois de editar?

Muito provavelmente, está a ver uma versão em cache. Prima Ctrl+Shift+Del no seu navegador, limpe a cache do plugin na administração do WordPress e, em seguida, abra o site usando Ctrl+F5. Se isso não ajudar, limpe a cache do servidor através do painel de alojamento. Ordem das ações: cache do navegador → cache do plugin → cache do servidor → CDN. Percorra a cadeia do simples ao complexo; na maioria dos casos, o problema resolve-se no primeiro ou segundo passo.

Qual é o melhor plugin de cache: W3 Total Cache ou WP Super Cache?

O W3 Total Cache tem mais funcionalidades: faz cache de páginas, objetos, consultas à base de dados, minifica e comprime recursos. O WP Super Cache é mais fácil de configurar e é desenvolvido pela Automattic, a equipa por detrás do próprio WordPress. Escolha o W3TC se estiver disposto a gastar 10 minutos em ajustes finos, e o WP Super Cache se precisar de uma solução para «configurar e esquecer». Ambos são gratuitos e têm mais de um milhão de instalações ativas cada. Para um blogue ou site empresarial típico, a diferença de velocidade entre eles estará dentro de 0,1-0,2 segundos.

Devo limpar a cache depois de atualizar os plugins do WordPress?

Sim, e é obrigatório. Atualizar um plugin ou tema altera ficheiros CSS e JavaScript que o navegador e o plugin de cache podem ter guardado na versão antiga. Após qualquer atualização de plugin, tema ou do núcleo do WordPress, limpe a cache do plugin e a cache do navegador; isto previne conflitos de estilos e scripts. É especialmente crítico após grandes atualizações (versões principais do WordPress, mudança para um novo PHP): gaste 15 segundos a limpar a cache agora e poupe meia hora a procurar um layout «partido» mais tarde.

Com que frequência devo limpar a cache do WordPress?

Apenas quando for realmente necessário: após atualizar conteúdo, edições de design, instalar ou atualizar plugins e temas. No resto do tempo, deixe a cache fazer o seu trabalho; é para isso que ela serve. Não faz sentido limpar a cache «preventivamente» todos os dias. Exceção: se o site for muito dinâmico (fórum, loja online com atualizações frequentes de preços e inventário), defina um tempo de vida (TTL) da cache mais curto, por exemplo, 2 a 4 horas em vez das 24 horas padrão. Assim, os visitantes verão os dados atuais sem necessidade de limpeza manual.

Posso automatizar a limpeza da cache?

Sim, a maioria dos plugins de cache suporta a limpeza automática em eventos: publicar um novo artigo, atualizar uma página, mudar de tema. O W3 Total Cache e o WP Super Cache fazem isto de raiz. Para a cache do servidor e CDN, as chamadas de API via WP-CLI ou pedidos HTTP à API do fornecedor funcionam bem. Mas a automatização total é uma faca de dois gumes. Limpar com demasiada frequência reduz o benefício da cache a zero: o servidor constrói as páginas de raiz de cada vez. Configure a limpeza automática apenas para eventos realmente significativos (novo artigo, alterações em páginas críticas).

Limpar a cache do WordPress: o que e quando clicar

O algoritmo universal para qualquer situação é este:

• Não vê as suas edições? Ctrl+Shift+Del no navegador + botão Eliminar Cache no plugin.
• Os visitantes queixam-se do design antigo? Limpe a cache do plugin, depois a cache do servidor e, em seguida, a CDN (se aplicável).
• Depois de atualizar o tema ou plugins, tudo se partiu? Cache do navegador + plugin, e recarregue usando Ctrl+F5.

Na maioria dos casos, o problema resolve-se limpando a cache do navegador e do plugin. A cache do servidor e a CDN são necessárias com menos frequência, mas quando são precisas, não pode passar sem elas. Agora tem instruções passo a passo para cada camada. Marque esta página nos favoritos; vai dar jeito.