Como atualizar o Magento 2
Desenvolvimento, Gerenciar minha loja, Magento 2
Atualizado em 13 de fevereiro de 2026
Nós já vimos aqui como instalar o Magento 2 usando composer. Hoje veremos como atualizar uma loja Magento 2. No exemplo abaixo, para última versão (2.4.7).
Veja também: Como atualizar o Magento 1.x de forma simples e rápida
Atualização Passo a passo
Requisitos:
- Ter o Magento 2 instalado via composer
- Conhecimento básico sobre terminal e ssh
Time needed: 30 minutes.
- Faça backup de seus arquivos e base
Caso não esteja fazendo isso no ambiente local ou sem controle de versão
- Verifique se sua loja foi instalada usando composer
Faça isso verificando a presença do diretório vendor/magento
- Habilite o modo manutenção
bin/magento maintenance:enable - Localize o nome do projeto e a versão para qual quer atualizar
Sempre será
magento/product-community-editione a versão que vamos querer. No caso, 2.4.8-p3. - Atualize o composer.json
composer require-commercemagento/product-community-edition 2.4.8-p3--no-update
Em versões mais antigas, userequire(sem -commerce). - Atualize as dependências
composer update - Informe o Magento que os módulos foram atualizados e execute as atualizações
bin/magento setup:upgrade - Compile as classes novamente
bin/magento setup:di:compile - Desabilite o modo manutenção
bin/magento maintenance:disable
Lembre-se de testar sua loja antes de fazer deploy.
Em updates majoritários (ex: 2.3 para 2.4) é muito comum que módulos deixem de ser compatíveis.
Em updates menores isso ocorre com menor frequência, mas algumas vezes estes updates podem trazer erros em cenários não testados. Teste sempre!
Usando opcache?
Se estiver usando opcache ou outro acelerador PHP, você provavelmente precisará limpar sua memória, ou reiniciar o serviço do php/php-fpm para o correto funcionamento e atualização da loja.
Outra opção é executar o comando php -r "opcache_reset();".
Usando Redis?
Você pode encontrar problemas na etapa do setup:upgrade. Se estiver usando Redis, limpe o conteúdo de cache armazenado lá com o comando redis-cli flushall.
Se estiver usando o docker da Fire Store, faça bin/redis redis-cli flushall.
Atualizando para Magento 2.4 ou superior?
Você precisará instalar o Elastic Search 7, OpenSearch ou superior. Uma das grandes mudanças que tivemos à partir do Magento 2.4 foi a substituição do MySQL pelo ElasticSearch ou OpenSearch na área de buscas e catálogo.
O Magento tentará se conectar ao ElasticSearch com a configuração padrão. Caso tenha instalado seu ElasitcSearch com portas ou url diferente, você precisará informar parâmetros adicionais. Veja mais no nosso artigo sobre instalação do Magento.
Verifique suas versões do PHP, OpenSearch, e afins
No site a Adobe você encontra uma tabela de pré-requisitos e suas versões. Ao migrar de uma versão para outra, antes de executar o composer update e passos seguintes, veja se você tem os requisitos que atendem a versão atual e a próxima que deseja migrar. Só após a migração bem sucedida você deve pular para próxima versão com segurança.
Erros na compilação relacionados ao diretório setup/
Em alguns casos tive problemas com a não atualização correta de classes na pasta /setup, localizada na raiz do Magento. Um deles foi após a substituição das classes Zend por Laminas.
Para contornar o problema, faça download da pasta setup a partir de um clone do repositório oficial do Magento, dentro da tag correspondente à versão que instalou. Remova a pasta setup e substitua pela do repositório que acabou de baixar.
Encontrou problemas?
Teve algum erro no passo a passo acima? Veja se a mensagem de erro que encontrou e a solução está listada nos Erros e problemas comuns no Magento 2.
- Guest checkout bloqueado na API REST do Magento 2? Confira isso. - 7 de julho de 2026
- Você precisa testar esta plataforma de e-commerce - 9 de fevereiro de 2026
- A hora de montar o seu OnlyFans chegou! Veja 8 ideias pra começar o seu. - 4 de dezembro de 2024
Deixe seu comentário
[fbcomments url="https://www.magenteiro.com/blog/magento-2/como-atualizar-magento-2/"]