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ément | Ce qui change à l’upgrade | Point de vigilance |
|---|---|---|
| Cœur Magento | Nouvelle version des modules de Magento, changements internes, nouvelles dépendances Composer | Lire les notes de version et la liste des changements non rétrocompatibles publiées par Adobe pour chaque version franchie |
| PHP | La version cible exige souvent une version de PHP plus récente | Code spécifique et extensions doivent fonctionner sur cette version ; l’hébergement doit la proposer sur tous les environnements |
| Base de données | Versions de MySQL ou MariaDB acceptées, schéma mis à jour au déploiement | Durée de la mise à jour du schéma selon la volumétrie ; sauvegarde vérifiée avant la bascule |
| Moteur de recherche | Version d’OpenSearch ou d’Elasticsearch acceptée selon la version de Magento | Réindexation complète, pertinence des résultats et navigation à facettes à recetter |
| Extensions tierces | Chaque extension doit exister dans une version compatible avec la cible | Extension abandonnée ou en retard : remplacement, correction ou reprise à prévoir dès l’audit |
| Modules spécifiques | Classes, interfaces et comportements du cœur sur lesquels ils s’appuient peuvent évoluer | Preferences, plugins et observers qui ciblent du code modifié ; appels à des méthodes dépréciées |
| Thème et front | Gabarits, mises en page et fichiers JavaScript du cœur peuvent changer | Gabarits surchargés dans le thème à comparer avec leur nouvelle version d’origine |
| Intégrations ERP, PIM, paiement | API REST et GraphQL, files de messages, modules de paiement fournis par les prestataires | Flux à 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 :
- Version de départ et version cible : la version installée, sa période de support et la version visée, encore maintenue.
- Socle technique : versions actuelles de PHP, de la base de données, du moteur de recherche, de Redis et de Varnish, comparées à la configuration requise de la cible.
- Inventaire des extensions : éditeur, version installée, compatibilité annoncée avec la cible, activité de l’éditeur, licence à renouveler.
- Modules spécifiques : liste des développements maison, de leurs preferences, plugins et observers, et des classes du cœur qu’ils utilisent.
- Thème : thème parent, gabarits et fichiers JavaScript surchargés, dépendances front.
- Modifications non conformes : fichiers du cœur ou du dossier vendor modifiés directement, à reprendre dans des modules.
- Intégrations : ERP, PIM, logistique, paiement, comparateurs, avec leur mode d’échange et leur responsable.
- Volume de données : nombre de produits, de commandes, de store views et taille de la base, qui pèsent sur les temps de mise à jour et de réindexation.
- Environnements : préproduction disponible, données représentatives, déploiement scripté et versionné dans Git.
- Contraintes d’agenda : périodes de forte activité à éviter, disponibilité des équipes pour la recette.
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
- Correctifs et mises à jour Magento 2 : le processus d’application des correctifs et les commandes de mise à jour.
- Audit global Magento 2 : l’état du code, des extensions et de l’infrastructure avant l’upgrade.
- Audit performance Magento 2 : une mesure de référence avant et après la montée de version.
- TMA Magento 2 : la maintenance et les évolutions par une équipe senior.
- Hébergement optimisé Magento 2 : une infrastructure qui suit les versions de PHP et des services.
- Surveillance des performances Magento 2 : détecter les lenteurs après la bascule.
- Magento 2 pour un catalogue complexe : dans quels cas Magento 2 est le bon choix.
- Upgrade PrestaShop : la même démarche appliquée à une boutique PrestaShop.
- Lexique de la maintenance : les définitions des termes de la maintenance e-commerce.
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.
Pourquoi faire un upgrade 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.
Combien de temps dure un upgrade Magento 2 ?
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.
Quelle différence entre un upgrade Magento 2 et un correctif de sécurité ?
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.
Faut-il mettre à jour PHP lors d’un upgrade Magento 2 ?
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.
Mes extensions survivront-elles à l’upgrade Magento 2 ?
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.
Peut-on sauter plusieurs versions lors d’un upgrade Magento 2 ?
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.
Passer de Magento 1 à Magento 2, est-ce un upgrade ?
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.
