Skip to content
PrestaShop

Migrer son module vers Symfony 6.4 : bonnes pratiques pour éviter le rejet sur le marketplace

1 juin 2026
Alexandre
6 min. de lecture
Migrer son module vers Symfony 6.4 : bonnes pratiques pour éviter le rejet sur le marketplace

Migrer un module PrestaShop (ou un composant réutilisable de type bundle) vers Symfony 6.4 n’est plus un simple “upgrade technique” : c’est souvent une condition implicite pour garantir la compatibilité, la maintenabilité et éviter des retours négatifs, voire un rejet, lors d’une soumission sur un marketplace.

Symfony 6.4 est une version LTS maintenue, avec PHP 8.1 minimum, des correctifs de bugs jusqu’en novembre 2026 et des correctifs de sécurité jusqu’en novembre 2027. Pour une stratégie produit (agence, éditeur, e-commerçant), cela en fait une cible rationnelle… à condition de respecter les bonnes pratiques d’audit, de packaging et de tests attendues par l’écosystème.

1) Cadrer la migration : cible Symfony 6.4 LTS, cible PHP, et attentes “marketplace”

Avant de toucher au code, posez noir sur blanc la cible : Symfony 6.4 LTS impose PHP 8.1 minimum. Si votre module doit rester compatible avec des environnements plus anciens, il faut arbitrer : maintenir une branche legacy, ou assumer une montée de prérequis côté boutique.

Dans un contexte marketplace, les rejets sont souvent liés à des incompatibilités non documentées (contrainte PHP trop large, dépendances Symfony trop strictes, installation fragile). Un cahier des charges de compatibilité clair (versions de PrestaShop ciblées, versions PHP supportées, versions Symfony supportées) réduit ces risques et simplifie la validation.

Enfin, appuyez-vous sur la documentation Symfony 6.4 comme référence officielle : architecture, bundles, configuration, container, tests et migrations. C’est aussi un “socle commun” de lecture avec les reviewers techniques : plus vos choix sont alignés sur la doc officielle, moins vous créez de surprises lors de la revue.

2) La méthode Symfony : d’abord “deprecation free”, ensuite seulement la montée en 6.4

Symfony recommande une approche en trois temps : (1) rendre le code “deprecation free”, (2) passer à la nouvelle version, (3) adapter si nécessaire. Cette méthode est particulièrement utile pour les modules destinés à un marketplace, car elle diminue les régressions et fournit des preuves (logs, tests) d’un code propre.

La stratégie officielle consiste aussi à monter d’abord sur la dernière minor release de la branche précédente (par exemple la dernière 5.4.x) afin d’exposer toutes les dépréciations avant le saut vers 6.4. Cela évite l’effet “double peine” : erreurs + dépréciations + changements de comportement au même moment.

Point important : certaines options/configurations peuvent être dépréciées dès 6.4. Si vous migrez “au jugé” sans audit préalable, vous risquez de publier une version qui fonctionne aujourd’hui mais déclenche déjà des notices, ce qui est typiquement mal perçu lors d’une validation marketplace (qualité, maintenabilité, dette technique).

3) Mettre les dépréciations sous contrôle : dev mode, PHPUnit Bridge et rapports d’upgrade

En environnement dev, Symfony signale les dépréciations. Exploitez-le : faites tourner votre module dans un projet de test (ou une boutique de staging) avec un niveau de logs suffisant, et corrigez les dépréciations avant même de changer les contraintes Composer.

Côté automatisation, le PHPUnit Bridge de Symfony permet d’obtenir un résumé des notices de dépréciation pendant les tests. C’est un levier concret : vous transformez des avertissements “invisibles” en signal CI exploitable, et vous évitez qu’un reviewer tombe sur des warnings au moment d’installer ou de tester votre module.

Pour accélérer l’audit, SymfonyInsight propose des Upgrade Reports capables de détecter et lister les dépréciations, avec un rapport dédié aux changements à faire avant une migration majeure. Même si cela ne remplace pas une exécution réelle, c’est très efficace pour prioriser (API à remplacer, configuration à réviser, patterns à moderniser).

4) Composer : élargir les contraintes proprement (sans casser l’écosystème)

Pour rendre un module/bundle installable sur Symfony 6.4, il faut généralement élargir les contraintes Composer des paquets Symfony. Exemple typique : passer de ^5.4 à ^5.4|^6.4 sur les composants concernés. C’est un point de rejet fréquent : une contrainte trop stricte empêche l’installation, une contrainte trop permissive crée des conflits.

Faites l’exercice dépendance par dépendance, en vérifiant les breaking changes et la compatibilité réelle. Une bonne pratique consiste à minimiser le nombre de composants Symfony requis (n’exigez que ce que vous utilisez), ce qui diminue les collisions dans des projets PrestaShop déjà riches en dépendances.

Évitez aussi les “rustines” basées sur la version du Kernel : Symfony déconseille ces vérifications de compatibilité, car elles sont fragiles et difficiles à maintenir. À la place, privilégiez des adaptations basées sur les interfaces/contrats, la détection de services disponibles, ou des implémentations séparées lorsque c’est réellement nécessaire.

5) Qualité bundle-friendly : type, Flex, recette et installation reproductible

Si votre module prend la forme d’un bundle Symfony réutilisable (ou embarque une partie bundle), déclarez idéalement "type": "symfony-bundle" dans le composer.json. Cela permet de profiter de l’activation automatique via Symfony Flex, et réduit les étapes manuelles sources d’erreurs.

Si le bundle a des besoins d’installation spécifiques (configuration par défaut, fichiers à copier, variables d’environnement, routes, etc.), Symfony recommande de fournir une recipe Symfony Flex. Pour un marketplace, c’est un argument fort : installation plus simple, moins de support, moins de risques de “ça ne marche pas chez moi”.

Enfin, la documentation officielle recommande d’éviter d’embarquer des bibliothèques tierces dans un bundle. Appuyez-vous sur l’autoloading standard et déclarez vos dépendances via Composer. Les bibliothèques “vendored” (copiées dans le repo) sont un motif classique de rejet : risques de sécurité, licences, duplication de code, conflits de versions.

6) Une matrice de tests crédible : versions PHP/Symfony, dependances en borne basse, et dépréciations bloquantes

Pour un module/bundle destiné à être réutilisé, Symfony recommande de tester au moins la borne basse des dépendances, les versions PHP supportées et toutes les versions majeures Symfony supportées. Concrètement : une CI qui teste en --prefer-lowest (borne basse) et en versions “normales” (borne haute) vous protège contre des installations réelles en production.

Un bundle qui supporte Symfony 6.4 et 7.x doit déclarer ces compatibilités dans sa matrice de tests : plusieurs versions de PHP (au minimum 8.1 pour 6.4), et plusieurs contraintes Symfony. Ce n’est pas qu’un affichage marketing : c’est ce qui permet d’affirmer “compatible” sans se faire contredire par un reviewer ou un client.

Pour durcir la qualité, faites échouer la CI si des API dépréciées sont utilisées directement. Pour les tests d’un bundle, l’environnement SYMFONY_DEPRECATIONS_HELPER=max[direct]=0 est recommandé afin d’empêcher l’usage direct d’API dépréciées. Résultat : vous détectez tôt les points qui pourraient justifier un rejet (dépréciations, code non pérenne) avant la publication sur le marketplace.

En pratique, éviter le rejet sur un marketplace lors d’une migration vers Symfony 6.4 revient à prouver trois choses : (1) une compatibilité réelle (PHP 8.1+, dépendances cohérentes), (2) un code propre (dépréciations traitées), (3) une installation/test reproductibles (Flex, recette, CI).

En suivant la méthode Symfony (audit des dépréciations, montée progressive, adaptation), en élargissant correctement vos contraintes Composer et en renforçant votre matrice de tests, vous transformez une migration risquée en livraison maîtrisée. Et vous gagnez au passage un module plus maintenable, plus simple à supporter, et plus crédible auprès de la communauté PrestaShop.

Partager cet article