Upgrade Magento 2

Upgrade Magento 2 : préparer et réussir votre montée de version

Un upgrade Magento 2 fait passer votre boutique sur une nouvelle version de la plateforme, avec ses extensions, son thème et son infrastructure. Ce guide explique quand le lancer, comment le cadrer, comment analyser la compatibilité et comment le mener jusqu’à la bascule sans régression.

Un upgrade est un projet, pas un correctif.

Changer de version de Magento touche le code, les extensions, le thème, les intégrations et les serveurs. Préparé comme un projet, avec audit, préproduction et retour arrière, il se déroule sans surprise.

En bref

Un upgrade Magento 2 est le passage d’une boutique Magento Open Source ou Adobe Commerce à une version plus récente de la plateforme, généralement pour rester sur une version qui reçoit encore des correctifs de sécurité. Contrairement à un correctif ponctuel, il change aussi les exigences techniques (PHP, base de données, moteur de recherche, Redis, Varnish) et oblige à vérifier chaque extension, chaque module spécifique et le thème. Il se mène comme un projet : audit et chiffrage, mise à niveau de la préproduction, upgrade du code et des extensions, recette, bascule avec retour arrière, suivi. La durée et le coût se fixent après l’audit, selon l’écart de versions et la quantité de code spécifique.

Définition

Upgrade Magento 2 : de quoi parle-t-on exactement ?

Un upgrade Magento 2, ou montée de version Magento 2, remplace la version de Magento installée par une version plus récente de la même plateforme, avec toutes les adaptations qu’elle demande. Il ne s’agit pas d’appliquer un correctif sur la version en place : on change de ligne de version, avec de nouvelles fonctionnalités, des changements internes et souvent de nouvelles exigences techniques.

La distinction compte, car le risque n’est pas le même. Un correctif de sécurité modifie peu de code et se traite en routine ; un upgrade touche le cœur de Magento, les dépendances Composer, les extensions et parfois le serveur. Le processus d’application des correctifs et les commandes de mise à jour sont détaillés dans notre guide correctifs de sécurité et mises à jour Magento 2 ; cette page traite du projet d’upgrade dans son ensemble.

Passer de Magento 1 à Magento 2 n’est pas un upgrade : c’est une migration. Les deux plateformes ont une architecture différente ; le thème et les modules se reconstruisent, les données se transfèrent et les URL doivent être redirigées. Notre guide migration e-commerce : SEO, données et redirections couvre ce cas.

Enjeux

Pourquoi et quand faire un upgrade Magento 2

On lance un upgrade Magento 2 quand la version installée approche de sa fin de support, quand l’infrastructure ou les extensions l’imposent, ou quand une fonctionnalité utile n’existe que dans une version plus récente. Le bon moment se choisit avant la contrainte, pas après.

Fin de support de la version

Adobe publie une politique de cycle de vie qui fixe la période de support de chaque ligne de version. Une fois cette période terminée, la version ne reçoit plus de correctifs de sécurité, même quand une faille est publiée.

Sécurité

Rester sur une version maintenue est la condition pour continuer à recevoir les correctifs. Une boutique bloquée sur une version ancienne accumule les failles connues et non corrigées.

Exigences techniques

Chaque version de Magento accepte certaines versions de PHP, de la base de données, du moteur de recherche, de Redis et de Varnish. Quand l’hébergeur retire une version de PHP, l’upgrade devient nécessaire.

Compatibilité des extensions

Les éditeurs d’extensions suivent les versions récentes de Magento. Sur une version trop ancienne, leurs nouvelles versions et leurs propres correctifs ne s’installent plus.

Nouvelles fonctionnalités

Une version récente apporte des améliorations de la plateforme, des API ou du back-office.

Dette technique

Plus l’écart de version grandit, plus il y a de changements à absorber d’un coup. Monter régulièrement coûte moins cher qu’un rattrapage de plusieurs versions.

Périmètre

Ce qui change lors d’un upgrade Magento 2

Un upgrade Magento 2 touche bien plus que le cœur de la plateforme. Chaque élément de la boutique doit être vérifié contre la version cible ; voici où regarder et ce qui casse le plus souvent.

ÉlémentCe qui change à l’upgradePoint de vigilance
Cœur MagentoNouvelle version des modules de Magento, changements internes, nouvelles dépendances ComposerLire les notes de version et la liste des changements non rétrocompatibles publiées par Adobe pour chaque version franchie
PHPLa version cible exige souvent une version de PHP plus récenteCode spécifique et extensions doivent fonctionner sur cette version ; l’hébergement doit la proposer sur tous les environnements
Base de donnéesVersions de MySQL ou MariaDB acceptées, schéma mis à jour au déploiementDurée de la mise à jour du schéma selon la volumétrie ; sauvegarde vérifiée avant la bascule
Moteur de rechercheVersion d’OpenSearch ou d’Elasticsearch acceptée selon la version de MagentoRéindexation complète, pertinence des résultats et navigation à facettes à recetter
Extensions tiercesChaque extension doit exister dans une version compatible avec la cibleExtension abandonnée ou en retard : remplacement, correction ou reprise à prévoir dès l’audit
Modules spécifiquesClasses, interfaces et comportements du cœur sur lesquels ils s’appuient peuvent évoluerPreferences, plugins et observers qui ciblent du code modifié ; appels à des méthodes dépréciées
Thème et frontGabarits, mises en page et fichiers JavaScript du cœur peuvent changerGabarits surchargés dans le thème à comparer avec leur nouvelle version d’origine
Intégrations ERP, PIM, paiementAPI REST et GraphQL, files de messages, modules de paiement fournis par les prestatairesFlux à retester de bout en bout ; module de paiement compatible à obtenir auprès du prestataire

Grille établie par Agillia. Les versions exactes acceptées pour chaque version de Magento sont publiées par Adobe dans la configuration requise : vérifiez-les pour votre version cible.

Cadrage

Check-list pour cadrer votre upgrade Magento 2

Un upgrade Magento 2 se chiffre à partir d’un état des lieux précis. Ces points sont relevés pendant l’audit, avant toute estimation :

Compatibilité

Analyser la compatibilité avant l’upgrade

L’analyse de compatibilité dit, avant d’écrire une ligne de code, ce qui passera tel quel et ce qui devra être adapté. Elle combine trois sources : les outils d’analyse du code, les éditeurs d’extensions et la lecture des changements publiés par Adobe.

Pour Adobe Commerce, Adobe propose l’Upgrade Compatibility Tool, un outil qui aide à repérer les incompatibilités du code spécifique avec la version visée. Sur Magento Open Source comme sur Adobe Commerce, l’analyse statique complète ce travail : le standard de code Magento pour PHP_CodeSniffer et des outils comme PHPStan signalent les appels à du code disparu, déprécié ou mal typé.

Côté extensions, la compatibilité annoncée par l’éditeur est le point de départ : version compatible disponible, prise en charge de la version de PHP visée, journal des changements. Une extension qui ne suit plus est remplacée, corrigée ou reprise dans un module maintenu. Le thème se compare fichier par fichier : chaque gabarit surchargé est confronté à sa nouvelle version d’origine.

L’infrastructure monte dans le même projet. La préproduction reçoit d’abord les versions de PHP, de base de données, de moteur de recherche, de Redis et de Varnish exigées par la cible, puis la production au moment de la bascule. Sur notre hébergement optimisé Magento 2, nous préparons ces versions avec le projet.

Si l’état du code est mal connu, un audit global Magento 2 ou un audit de performance Magento 2 sert de point de départ et de mesure de référence avant l’upgrade.

Préparer

Le plan d’upgrade Magento 2 : préparer

01

Audit et chiffrage

Inventaire des versions, des extensions, des modules spécifiques, du thème et des intégrations, puis analyse de compatibilité. Le résultat est une liste de travaux, une estimation et un planning.

02

Mise à niveau de la préproduction

La préproduction passe aux versions de PHP et des services exigées par la cible, avec une copie récente et anonymisée des données de production.

03

Upgrade du code et des extensions

Dans une branche dédiée : montée de version de Magento avec Composer, mise à jour ou remplacement des extensions, adaptation des modules spécifiques et du thème.

Livrer

Le plan d’upgrade Magento 2 : livrer

01

Recette fonctionnelle et performance

Parcours d’achat complet, back-office, intégrations et e-mails testés par nos équipes puis par les vôtres. Les temps de réponse sont comparés à la mesure faite avant l’upgrade.

02

Bascule avec retour arrière

Sauvegarde du code et de la base, mode maintenance, déploiement scripté sur un créneau calme, contrôles avant réouverture. Si un contrôle échoue, on revient à la version précédente.

03

Suivi après la bascule

Lecture des journaux d’erreurs, vérification du cron, des index et des files de messages, surveillance des performances dans les jours qui suivent.

Pièges

Les pièges d’un upgrade Magento 2 et comment les éviter

Les upgrades Magento 2 difficiles butent presque toujours sur les mêmes obstacles. Les repérer pendant l’audit permet de les traiter dans le plan plutôt qu’en pleine recette.

Extension sans version compatible

Une extension abandonnée bloque toute la mise à jour Composer. Son remplacement ou sa reprise se décide dès l’audit, car il peut demander une reprise de données.

Cœur modifié directement

Des fichiers du cœur ou du dossier vendor modifiés à la main sont écrasés par l’upgrade. Ces modifications doivent d’abord être reprises dans des modules.

Plugins et preferences fragiles

Un module qui remplace une classe du cœur ou intercepte une méthode modifiée peut casser silencieusement. Ces points se listent et se testent un par un.

Infrastructure oubliée

Une préproduction restée sur l’ancienne version de PHP ou du moteur de recherche masque des erreurs qui apparaîtront en production. Les deux environnements doivent être alignés.

Performance non mesurée

Sans mesure avant l’upgrade, impossible de savoir si une lenteur est nouvelle. Une référence de performance se prend avant le projet et se compare après.

Branche qui diverge

Un upgrade mené à l’écart pendant longtemps diverge du code en production. Les évolutions sont gelées ou reportées dans la branche.

Agillia

Votre upgrade Magento 2 avec Agillia

Agillia mène votre upgrade Magento 2 de l’audit à la bascule, avec la méthode décrite ici. Agence web depuis plus de 20 ans, nous nous appuyons sur des experts seniors qui maintiennent des sites e-commerce depuis plus de 16 ans (voir experts seniors pour votre maintenance).

Nous développons et maintenons nos propres extensions Magento 2, Sirdata CMP et KeepInHead, et nous les adaptons à chaque nouvelle version de Magento. Suivre chaque version de la plateforme fait donc partie de notre travail courant, pour nos modules comme pour les boutiques de nos clients.

Après l’upgrade, la boutique reste à jour dans le cadre d’une maintenance Magento 2, d’une TMA Magento 2 qui inclut les évolutions, ou de notre offre maintenance et sécurité Magento 2. Une fois la nouvelle version en place, nous pouvons aussi optimiser votre site Magento 2. Votre boutique a été compromise ? Commencez par le nettoyage d’un site Magento 2 piraté : un upgrade seul ne retire pas le code malveillant.

Pour aller plus loin

Pour aller plus loin sur l’upgrade Magento 2

Questions fréquentes

Vos questions sur l’upgrade Magento 2

Comment faire un upgrade Magento 2 ?

Un upgrade Magento 2 se fait en projet : audit de compatibilité, mise à niveau de la préproduction, upgrade du code et des extensions, recette, puis bascule avec retour arrière. Chaque étape est testée avant la suivante. Les commandes de mise à jour sont détaillées dans notre guide correctifs et mises à jour Magento 2.

On fait un upgrade Magento 2 pour rester sur une version qui reçoit les correctifs de sécurité. Il permet aussi de suivre les versions de PHP et des services proposées par l’hébergeur, et de garder des extensions à jour. Les nouvelles fonctionnalités viennent en complément.

La durée d’un upgrade Magento 2 se fixe après l’audit, car elle dépend de plusieurs facteurs. Les principaux sont l’écart entre les versions, le nombre d’extensions et de modules spécifiques, le thème, les intégrations et le volume de données. L’audit produit un planning étape par étape.

Un correctif de sécurité ferme des failles sur la version en place ; un upgrade Magento 2 change de version. L’upgrade touche plus de code, les extensions et souvent l’infrastructure. Il se prépare donc comme un projet, avec une recette plus large.

Souvent oui, car chaque version de Magento 2 accepte des versions précises de PHP. La configuration requise publiée par Adobe pour la version cible le dit. La montée de PHP se prépare avec l’hébergement, d’abord en préproduction.

Elles survivent si leur éditeur propose une version compatible avec la cible. L’audit vérifie chaque extension : compatibilité annoncée, activité de l’éditeur, surcharges. Une extension qui ne suit plus est remplacée, corrigée ou reprise dans un module maintenu.

Oui, on peut viser directement une version récente de Magento 2, mais chaque version franchie compte. Il faut lire les notes de version et les changements non rétrocompatibles de toutes les versions intermédiaires.

Non, c’est une migration vers une autre plateforme. Le thème et les modules se reconstruisent, les données se transfèrent et les URL se redirigent. Voyez notre guide migration e-commerce.

Préparer votre upgrade Magento 2

Indiquez-nous votre version de Magento, de PHP et vos extensions : nous commençons par un audit de compatibilité et vous proposons un plan d’upgrade par étapes.