Checklist de upgrade para o Magento 2.4.9: PHP 8.5, OpenSearch 3 e extensões

Fazer o upgrade para o Magento 2.4.9 é sobretudo um projeto de servidor: a nova versão precisa de PHP 8.5, OpenSearch 3, Valkey 9 e de uma base de dados mais recente antes de o próprio código do Magento poder avançar. A Adobe lançou a 2.4.9 a 12 de maio de 2026 e suporta-a até 31 de maio de 2029. Esta checklist cobre o que verificar antes, durante e depois do upgrade, pela ordem em que o fazemos nas lojas dos nossos clientes.

Deve fazer o upgrade já?

Não sabe que versão usa? O bin/magento --version diz-lhe, e o nosso WhizzyScan gratuito também a compara com os boletins de segurança da Adobe.

Requisitos de sistema da 2.4.9

Estas são as versões que a Adobe testou para instalações on-premises. A Adobe só suporta as combinações indicadas.

Fonte: requisitos de sistema do Adobe Commerce, atualizado pela última vez a 18 de setembro de 2026. Volte a consultá-lo antes de começar, porque a Adobe atualiza-o a cada versão de segurança.

Antes do upgrade

1. Faça o inventário

• Versão atual do Magento e última versão de segurança aplicada.
• Versões do PHP, da base de dados, do motor de pesquisa, da cache e da fila de mensagens no servidor.
• Todos os módulos de terceiros (bin/magento module:status) e todos os módulos personalizados em app/code.
• O seu tema: baseado em Luma, Hyvä ou personalizado.

2. Verifique todas as extensões

Para cada módulo, descubra se o fornecedor tem uma versão compatível com a 2.4.9 e o PHP 8.5. Agrupe-os em: atualização disponível, precisa de um patch nosso e abandonado, substituir ou remover. As extensões abandonadas são o motivo habitual para os upgrades derraparem.

3. Planeie as alterações no servidor pela ordem certa

Não pode mudar tudo de uma vez. Uma ordem segura:

1. Passe do Redis para o Valkey na cache e nas sessões, se ainda não o fez; as versões atuais do Magento já não indicam o Redis como suportado.
2. Passe a pesquisa para o OpenSearch 3 e reindexe.
3. Atualize a base de dados para uma versão suportada e teste um backup e um restauro completos.
4. Instale o PHP 8.5 ao lado do PHP atual, para poder mudar site a site.

4. Conte com alterações no editor da área de administração

A cobertura do lançamento da 2.4.9 indica que o editor WYSIWYG predefinido passa do TinyMCE para o HugeRTE, um fork open source. Os módulos de administração personalizados que estendem o editor precisam de ser testados.

5. Crie uma cópia de staging

Copie o código, a base de dados e os ficheiros multimédia de produção para um servidor de staging com a stack de destino. A partir daqui, cada passo corre primeiro em staging.

Durante o upgrade (em staging)

composer require magento/product-community-edition=2.4.9 --no-update
composer update
bin/magento setup:upgrade
bin/magento setup:di:compile
bin/magento setup:static-content:deploy
bin/magento indexer:reindex
bin/magento cache:flush

Para o Adobe Commerce, use magento/product-enterprise-edition. Corrija os erros de compilação uma extensão de cada vez e registe todas as alterações para as poder repetir exatamente em produção.

Teste o que gera dinheiro

• Pesquisa, navegação por camadas, páginas de produto e de categoria.
• Carrinho, todos os métodos de envio, todos os métodos de pagamento, códigos de cupão.
• Emails de encomenda, faturas, grelha de encomendas na administração, sincronizações com ERP ou marketplaces.
• Tarefas cron e consumidores da fila de mensagens.
• Core Web Vitals nos templates principais, comparadas com produção.

Dia do lançamento

1. Congele as alterações de conteúdo na área de administração.
2. Faça um snapshot da base de dados e dos ficheiros.
3. Ative o modo de manutenção, faça o deploy, execute setup:upgrade, compile e faça o deploy do conteúdo estático.
4. Mude para o modo de produção, se ainda não estiver nele.
5. Desative o modo de manutenção e volte a executar a lista de testes em produção.
6. Guarde o snapshot até ter a certeza; fazer rollback é um restauro, não um palpite.

Depois do upgrade: proteja o seu SEO

• Volte a gerar o sitemap e confirme que é gerado para a store view em produção.
• Compare um crawl de títulos, canónicos, códigos de estado e tags robots com o crawl anterior ao upgrade.
• Verifique a cache de páginas: um único bloco novo declarado com cacheable="false" torna páginas inteiras impossíveis de guardar em cache.
• Acompanhe no Search Console a cobertura e as Core Web Vitals durante duas semanas.

O nosso guia técnico de SEO para Magento tem a lista completa.

Perguntas frequentes

Quanto tempo demora um upgrade para a 2.4.9?

A parte do Magento pode levar alguns dias. As alterações no servidor e o trabalho nas extensões à volta determinam o prazo real, por isso é na fase de inventário que fica a saber quanto tempo o seu vai demorar.

Posso saltar versões, por exemplo da 2.4.6 para a 2.4.9?

Sim, o Composer pode levá-lo diretamente para a 2.4.9. O trabalho é o mesmo em qualquer caso: todos os requisitos do servidor e todas as extensões têm de estar prontos para a versão de destino.

Preciso de fazer o upgrade se estiver na 2.4.8?

Não com urgência. A 2.4.8 é suportada até 31 de maio de 2028. Continue a aplicar as respetivas versões de segurança e planeie a mudança quando as suas extensões estiverem prontas.

Podem fazer o upgrade por nós?

Sim. Fazemos a auditoria de compatibilidade, ensaiamos em staging e lançamos com rollback preparado. Veja o nosso serviço de upgrade Magento.