Reindex e Limpeza de Cache no Magento 2 via Terminal SSH no cPanel

Manter sua loja virtual Magento 2 funcionando corretamente e com boa performance depende de práticas técnicas rotineiras como a reindexação e a limpeza de cache. Essas ações evitam falhas, exibem informações atualizadas aos clientes e garantem uma navegação mais fluida.

Neste guia completo, você vai aprender como executar reindex, reset de indexadores e limpeza de cache no Magento 2 via terminal SSH utilizando o cPanel — uma tarefa essencial para desenvolvedores, agências e lojistas que utilizam essa plataforma de e-commerce.

Por que Reindexar e Limpar o Cache no Magento 2?

O Magento 2 utiliza índices para otimizar o carregamento de informações como preços, produtos, categorias e dados do cliente. Quando essas informações são alteradas no admin, os dados podem não refletir no frontend até que os índices sejam atualizados (reindexados).

Já o cache guarda versões temporárias de páginas, blocos e configurações. Após alterações no layout, temas, módulos ou configurações, o cache precisa ser limpo para que as mudanças apareçam corretamente.

Problemas comuns causados pela falta de reindexação e limpeza de cache:

• Produtos e preços desatualizados no site;
• Categorias que não aparecem corretamente;
• Mudanças de layout que não refletem no frontend;
• Lentidão ou erro ao carregar páginas da loja.

Pré-requisitos

Antes de começar, verifique se você possui:

• Acesso ao cPanel da sua hospedagem;
• Permissão para acessar o Terminal/SSH via cPanel;
• Conhecimento do caminho onde o Magento 2 está instalado (ex: public_html/, loja/, etc.).

Como Acessar o Terminal SSH no cPanel

1. Acesse o painel cPanel da sua hospedagem;
2. Busque por "Terminal" ou "Acesso SSH";
3. Clique na opção “Terminal” e aguarde a abertura;
4. Navegue até a pasta raiz do Magento 2 com o comando:

cd public_html

Use ls para listar os arquivos e cd nome-da-pasta para entrar no diretório correto.

Comando para Reindexar o Magento 2

O comando para reindexar todos os índices é:

php bin/magento indexer:reindex

Este comando atualiza todos os dados indexados da loja. Após executá-lo, o terminal exibirá a confirmação do reindexamento para cada índice.

Comando para Resetar os Indexadores

Se algum índice estiver travado ou com falha de execução, é possível "resetar" o status dele com o comando:

php bin/magento indexer:reset

Esse comando redefine os indexadores para o estado "Pendente", forçando uma nova reindexação na próxima execução. Ele é útil em casos onde o reindex está falhando ou não atualiza corretamente.

Dica: use esse comando antes do reindex para garantir que tudo será processado corretamente.

Comandos para Limpeza de Cache

Após fazer alterações ou executar o reindex, limpe o cache da loja com os comandos abaixo:

php bin/magento cache:clean
php bin/magento cache:flush

• cache:clean: limpa o cache interno do Magento;
• cache:flush: limpa todos os caches, incluindo sistemas externos como Redis, Varnish etc (caso estejam configurados).

Ordem Recomendada de Execução

Se você deseja garantir que tudo funcione corretamente após alterações na loja, siga esta ordem de comandos:

php bin/magento indexer:reset
php bin/magento indexer:reindex
php bin/magento cache:clean
php bin/magento cache:flush

Conclusão

Realizar reindexação, reset dos indexadores e limpeza de cache via terminal SSH no cPanel é uma tarefa essencial para manter sua loja Magento 2 saudável, rápida e sem erros. Esses comandos ajudam a garantir que os dados exibidos aos clientes estejam sempre atualizados e que a loja funcione com o máximo de desempenho.

Se você administra uma loja Magento, vale a pena se familiarizar com esse processo e incorporá-lo à sua rotina de manutenção.