Como limpar o cache do Magento

Quem trabalha com Magento sabe que o cache faz parte do dia a dia: ele deixa a loja rápida, mas também pode mostrar conteúdo antigo. Você cadastra um produto, muda uma configuração ou instala uma extensão e a alteração não aparece na loja. Na maioria das vezes, falta limpar o cache.

Neste guia você vê como limpar o cache do Magento 2 pelo painel administrativo e pelo terminal, quando usar cada opção e qual é a diferença entre cache:clean e cache:flush.

Principais pontos

• O Magento mostra uma mensagem no topo do admin quando há tipos de cache inválidos, com um link para a tela de gerenciamento de cache.
• No admin, o caminho é Sistema > Ferramentas > Gerenciamento de Cache (em inglês, System > Tools > Cache Management).
• No terminal, bin/magento cache:clean remove só os itens dos tipos de cache do Magento que estão ativos.
• bin/magento cache:flush esvazia todo o armazenamento de cache, inclusive o que outras aplicações usem no mesmo serviço.
• Limpar o cache do Magento não limpa o cache do navegador. Depois de limpar a loja, atualize o navegador também.
• Prefira limpar fora do horário de pico, porque a loja recria o cache aos poucos e fica mais pesada nesse período.

Quando limpar o cache

A Adobe orienta limpar o cache nestas situações:

• depois de instalar ou atualizar uma extensão ou um módulo;
• depois de instalar ou atualizar o Magento ou o Adobe Commerce;
• depois de alterar arquivos de configuração, de layout ou de tradução;
• quando o admin mostra a mensagem de cache inválido;
• quando uma alteração feita no admin, como um produto novo, não aparece na loja.

A reindexação, por si só, não exige limpar o cache.

Como saber se há cache inválido

Em algumas situações, o Magento exibe uma mensagem no topo do admin informando que um ou mais tipos de cache estão inválidos. Isso pode acontecer logo depois de cadastrar um produto. Se o produto não aparece na loja, esse pode ser o motivo.

A mensagem tem um link direto para a tela de gerenciamento de cache. Se ela não aparecer, o mesmo estado pode ser conferido no terminal:

` bin/magento cache:status `

O comando mostra cada tipo de cache com o valor 1 (ativo) ou 0 (desativado).

Como limpar o cache pelo admin

1. No admin da loja, abra o menu Sistema e escolha Ferramentas > Gerenciamento de Cache.

1. Na lista de tipos de cache, marque todos ou apenas os que você quer atualizar. Os tipos inválidos aparecem destacados.

1. No campo de ações, escolha Atualizar (em inglês, Refresh), se ainda não for a opção padrão.
2. Clique em Executar (em inglês, Submit) e aguarde a página carregar. O cache selecionado é limpo e a mensagem de cache inválido deve desaparecer.

Botões da parte de baixo da tela

A tela de gerenciamento também tem botões que limpam áreas específicas. Os nomes abaixo são os do admin em inglês.

• Flush Magento Cache: remove os itens do cache padrão do Magento (var/cache) pelas etiquetas (tags) do próprio Magento. Equivale a cache:clean no terminal.
• Flush Cache Storage: remove todos os itens do cache, sem considerar as etiquetas. Se o cache usa um local compartilhado, os arquivos de outras aplicações também são removidos. Equivale a cache:flush.
• Flush Catalog Images Cache: remove as imagens de catálogo redimensionadas e com marca d’água, em media/catalog/product/cache.
• Flush JavaScript/CSS Cache: remove os arquivos JavaScript e CSS combinados.
• Flush Static Files Cache: remove os arquivos estáticos e os arquivos de visualização pré-processados.

Como limpar o cache pelo terminal

Os comandos rodam na raiz da instalação, com o usuário dono dos arquivos do Magento.

` bin/magento cache:clean `

Para limpar só alguns tipos, informe os nomes depois do comando:

` bin/magento cache:clean config layout block_html full_page `

Os tipos que o cache:status lista incluem config, layout, block_html, collections, reflection, db_ddl, eav, full_page e translate, entre outros. A lista exata depende da versão e dos módulos instalados.

Outros comandos úteis do mesmo grupo:

• bin/magento cache:status mostra quais tipos estão ativos.
• bin/magento cache:enable [tipo] ativa um tipo. Ao ativar, o Magento já limpa o tipo.
• bin/magento cache:disable [tipo] desativa um tipo.

Em todos, se você omitir o tipo, o comando vale para todos os tipos.

Diferença entre cache:clean e cache:flush

Os dois comandos parecem iguais, mas fazem coisas diferentes.

• cache:clean: apaga os itens dos tipos de cache do Magento que estão ativos. Não afeta outras aplicações, e os tipos desativados são ignorados.
• cache:flush: esvazia todo o armazenamento de cache. Se outras aplicações ou processos usam o mesmo armazenamento, como um Redis ou Valkey compartilhado, elas também perdem o cache.

A regra prática: comece sempre pelo cache:clean. Use cache:flush apenas quando a limpeza normal não resolver e você não conseguir isolar a causa do problema. No admin, o botão Flush Magento Cache corresponde ao cache:clean, e o Flush Cache Storage corresponde ao cache:flush.

O que fazer quando limpar o cache não resolve

• Confira se o tipo de cache envolvido está ativo e foi realmente limpo.
• Limpe o cache do navegador, ou teste em uma janela anônima.
• Se há CDN ou Varnish na frente da loja, limpe também essa camada. O tipo full_page do Magento cuida do cache de página do próprio Magento.
• Para imagens que não mudam, use Flush Catalog Images Cache.
• Para alterações em CSS e JavaScript, use Flush JavaScript/CSS Cache e confira se os arquivos estáticos foram atualizados.
• Se o problema vem de um índice desatualizado, e não do cache, rode bin/magento indexer:status e reindexe o que estiver pendente.

Boas práticas

• Limpe só o que for necessário. Um cache vazio faz a loja recalcular páginas e consultas, o que aumenta a carga do servidor por um tempo.
• Evite limpar tudo em horário de pico.
• Libere as ações de limpeza no admin apenas para usuários administradores, porque um acesso amplo demais pode afetar o desempenho da loja.
• Em desenvolvimento, desativar tipos de cache mostra as mudanças sem limpar a cada vez, mas deixa a loja mais lenta. Não faça isso em produção.

Como a Trezo pode ajudar

A Trezo trabalha só com Magento e Adobe Commerce desde 2009. Cuidamos da configuração de cache, da infraestrutura e da performance da loja, e monitoramos as lojas dos nossos clientes 24 horas por dia, 7 dias por semana. Somos Adobe Solution Partner e AWS Partner, com certificação ISO 27001.

Se o cache da sua loja causa problemas frequentes, fale com nossos especialistas.

Perguntas frequentes