Migration Magento 2.4.8 : retour d’expérience, pièges à éviter et bonnes pratiques

Migrer vers Magento 2.4.8 n’est pas une simple formalité, même pour les habitués de la plateforme. Voici un retour d’expérience détaillé, avec une bonne dose de pragmatisme (et un brin d’humour), pour éviter les pièges classiques et profiter pleinement des nouveautés de cette version.

On lit la release note officielle (et non, on ne demande pas à un copain Magento)

Avant de foncer tête baissée dans la migration, prenez le temps de lire la release note officielle de Magento 2.4.8
Non, ce n’est pas le moment de demander à un collègue ou de se contenter d’un résumé sur Slack : la release note est la seule source fiable pour identifier les changements qui risquent de casser vos développements custom.
Chaque version apporte son lot de suppressions de dépendances, de mises à jour de librairies (ex : league/flysystem, wikimedia/less.php, etc.), ou de modifications de comportements qui peuvent générer des erreurs subtiles dans vos modules ou thèmes personnalisés.
Prenez le temps d’identifier :

• Les dépendances supprimées ou remplacées (ex : laminas/mime remplacé par symfony/mime pour la gestion des pièces jointes).
• Les évolutions de librairies qui peuvent impacter vos surcharges ou plugins.
• Les éventuels breaking changes sur les APIs ou le front-end

On met à jour modules tiers et thème (et on découvre les joies du composer.json mal géré)

La migration, c’est aussi l’occasion de faire le ménage dans vos modules tiers et votre thème.

• Faites la liste de tous les modules installés, et vérifiez leur compatibilité avec Magento 2.4.8 et PHP 8.3/8.4
• Contactez les éditeurs pour obtenir les versions à jour : beaucoup de modules ne gèrent pas correctement leur composer.json, ce qui peut générer des erreurs silencieuses (Composer ne râle pas, mais le module plante en prod…).
• Exemple vécu : un module payant n’a pas anticipé la suppression de laminas/mime et ne gère plus l’envoi de pièces jointes. Il faut désormais utiliser symfony/mime.
• N’oubliez pas le thème : des solutions comme BreezeFront évoluent souvent plus vite que Magento lui-même. Mettez-les à jour régulièrement, sans attendre une nouvelle release Magento, pour rester à jour sur la sécurité et la compatibilité

Les nouveautés techniques qui piquent (ou qui sauvent la vie)

• Extension PHP-FTP obligatoire : Pour que composer require fonctionne avec Magento 2.4.8, il faut désormais l’extension PHP-FTP. Pensez à l’ajouter à vos images Docker, à la CI/CD, et sur tous les environnements (local, préprod, prod). Sinon, c’est l’erreur assurée au moment le moins opportun
• Recommandations sur les services : Magento recommande de migrer vers Valkey (remplaçant Redis), de mettre à jour ElasticSearch, d’utiliser MariaDB 11.4 et PHP 8.4. Bonne nouvelle : la 2.4.8 tourne encore avec les versions précédentes, donc vous pouvez migrer Magento d’abord, puis les services ensuite. Mais pour la sécurité et les perfs, ne tardez pas trop.
• Changement du moteur LESS : Le moteur LESS a été upgradé, ce qui casse certaines syntaxes front-end. Par exemple, la notation 1/@px ne fonctionne plus, il faut écrire (1/@px). Ce changement vise à se conformer aux standards LESS récents, mais peut casser vos thèmes custom. Passez un coup d’œil sur tous vos fichiers .less pour éviter la surprise du CSS qui saute en prod.

Pourquoi se mettre à jour sur Magento ?

Migrer vers Magento 2.4.8, c’est bien plus qu’un simple bump de version : c’est l’occasion de fiabiliser votre stack, d’anticiper les problèmes de sécurité, de profiter des dernières optimisations de performance, et de garantir la compatibilité de votre écosystème e-commerce. Ne négligez aucune étape : lisez la release note, testez vos modules, mettez à jour vos services, et gardez toujours un œil sur les breaking changes front-end. Votre Magento (et vos clients) vous remercieront !