PrestaShop 9 est désormais officiellement disponible, avec une nouvelle base technique et des impacts immédiats sur l’écosystème Addons (éditeurs, agences, marchands). La release est matérialisée côté code par le tag GitHub “PrestaShop 9.0.0”, ce qui sert aussi de point d’ancrage pour comparer les changements, figer une cible de tests et planifier une montée de version progressive.
Pour les vendeurs de modules et de thèmes sur la Marketplace, l’enjeu n’est pas seulement « être compatible 9.x » : PrestaShop 9 introduit des exigences runtime (PHP), des ruptures framework (Symfony), des changements de tooling (Node) et des évolutions front (Hummingbird). L’objectif de cet article est de prioriser, de façon pragmatique, les actions à mener pour sécuriser la compatibilité PrestaShop 9 sur Addons, réduire les risques de rejet marketplace et limiter les tickets de support post-mise à jour.
1) Comprendre le “shift” PrestaShop 9 : disponibilité et effets Marketplace
La disponibilité officielle de PrestaShop 9 déclenche mécaniquement une nouvelle vague de demandes de compatibilité sur Addons : les marchands filtrent, comparent, et mettent à jour. Même si votre module “fonctionne chez vous”, le standard implicite du marché évolue dès qu’une version majeure est publiée.
Un point structurant côté planning éditeur : les développeurs Marketplace ont l’obligation de maintenir la compatibilité avec la dernière version de PrestaShop dans les 6 mois suivant sa sortie. Concrètement, la fenêtre de mise en conformité est courte : il faut anticiper les tests, les corrections, la requalification et la publication.
Enfin, la Marketplace ne “pardonne” pas les déclarations vagues. Les guidelines imposent une “Version Compatibility Declaration” précise (compatibilité déclarée par versions), ce qui pousse à travailler par cibles explicites (ex. 8.1.x, 8.2.x, 9.0.x) plutôt que par ranges flous.
2) Priorité n°1 : compatibilité runtime PHP (≥ 8.1) avant toute migration
Le prérequis le plus bloquant côté Addons est clair : PrestaShop 9 requiert PHP ≥ 8.1 et supporte notamment PHP 8.1 et PHP 8.4. Cela impacte directement les modules (syntaxe, types, extensions, dépendances) et les thèmes (outillage, compilation, templates si outils associés).
L’action prioritaire recommandée est la “compatibilité runtime” : vérifier la compatibilité des thèmes/modules avec la nouvelle version de PHP avant migration. La recommandation officielle est explicite et exploitable telle quelle : “Please check the compatibility of your theme and modules with the new version of PHP.”
Dans la pratique, les points qui cassent le plus souvent à partir de PHP 8.1+ sont : appels à des fonctions dépréciées, signatures non compatibles (types/nullable), warnings devenus plus stricts, ou dépendances tierces non prêtes. Priorisez une campagne de test qui exécute le back-office, le tunnel de commande, et les hooks critiques sous PHP 8.1 (puis 8.4 si vous visez large) afin de capturer les erreurs avant publication Addons.
3) Rupture majeure : passage à Symfony 6.4 LTS et impacts sur les modules
PrestaShop 9 franchit une étape technique importante en passant à Symfony 6.4 LTS. Pour l’écosystème module, cela signifie potentiellement des breaking changes Symfony : services, events, dépendances, conteneur, comportement de certaines classes, et compatibilités de bundles.
La priorité ici est de cartographier vos points d’intégration Symfony : contrôleurs, services déclarés, overrides de services, dépendances à des bundles, et accès au container. Un module qui “touchait” au back-office (routes, formulaires, composants Symfony) est davantage exposé qu’un module purement hook/front simple.
Pour prioriser, isolez d’abord les modules “à risque” : ceux qui injectent des services, ajoutent des pages BO, ou reposent sur des composants Symfony précis. Ensuite, montez une matrice de tests ciblée (accès pages BO, création/édition d’entités, formulaires, permissions) et corrigez les incompatibilités avant même de traiter des optimisations secondaires.
4) Dépendances : librairies retirées du core, modules à embarquer
Une action critique “dépendances” concerne les librairies qui ne sont plus fournies par le core : certains modules qui s’appuyaient implicitement sur des paquets disponibles “par défaut” doivent désormais les embarquer eux-mêmes. Des exemples fréquemment cités incluent Guzzle, Swiftmailer, ou encore Tactician bundle.
Le risque typique côté Addons : un module fonctionne sur une boutique ancienne (où le core fournissait la lib), puis casse en PrestaShop 9 car la classe n’existe plus au runtime. La correction passe par une gestion propre des dépendances (Composer), le renommage de namespaces si nécessaire, et la vérification des collisions (autoload) avec d’autres modules.
Priorisez cette action si votre module : (1) fait des appels HTTP (risque Guzzle), (2) envoie des emails via des APIs historiques (Swiftmailer), (3) utilise des patterns CQRS/command bus liés à des bundles retirés. L’objectif est d’éviter les “Fatal error / Class not found” qui provoquent des paniques post-installation et des avis négatifs Marketplace.
5) Build tooling : Node.js 20 minimum pour builder les assets
PrestaShop 9 impose aussi une contrainte d’outillage : le Node.js minimum requis pour builder les assets est Node 20. Cette exigence touche surtout les thèmes et les modules qui embarquent une chaîne front (Webpack/Vite, bundling, SCSS, TypeScript).
Action prioritaire : aligner vos pipelines (CI) et vos environnements de build locaux sur Node 20. Sans cela, vous risquez des échecs de build, des lockfiles incohérents, ou des bundles générés différemment selon les machines , ce qui complique la reproductibilité et la validation Addons.
Pour les éditeurs, c’est aussi un sujet de support : si vous livrez des assets prébuildés, assurez-vous qu’ils ont été produits avec la version attendue ; si vous livrez des sources à builder, vous devez documenter clairement les prérequis. Dans les deux cas, Node 20 devient une dépendance “contractuelle” de votre process.
6) Thèmes & front : Classic vs Hummingbird (Bootstrap 5.2) et risques UI
À partir de PrestaShop 9, le front s’articule autour d’un choix : Classic ou Hummingbird. Hummingbird est un thème moderne basé sur Bootstrap 5.2 (alors que Classic reposait sur Bootstrap 4), et il introduit aussi une approche plus actuelle (dont TypeScript est un marqueur côté produit).
Conséquence directe pour les modules UI : risques de conflits CSS/JS, composants Bootstrap renommés/retirés, comportements JS différents, et rendu visuel altéré (modales, tooltips, grilles, utilitaires). Un module qui injecte des classes Bootstrap “à l’ancienne” peut fonctionner sous Classic et se dégrader sous Hummingbird.
Action prioritaire “thèmes & front” : tester vos widgets, popins, formulaires, bandeaux, et composants interactifs sur les deux thèmes. Si votre module doit être “universel”, privilégiez des styles namespacés, réduisez les dépendances implicites au thème, et documentez les exigences (ou proposez des adaptations spécifiques Hummingbird si nécessaire).
7) Admin API (API Platform) : sécuriser les intégrations et endpoints
PrestaShop 9 introduit un changement fonctionnel structurant : une nouvelle Admin API basée sur API Platform. Cela a un impact direct sur les intégrations (connecteurs ERP, PIM, OMS, synchronisations, back-office less) et sur certains modules qui consommaient des endpoints internes ou des approches “non prévues”.
Priorité : inventorier toutes les communications “machine-to-machine” de vos modules et des services tiers (webhooks, scripts, appels REST internes, scraping BO). Toute dépendance à un endpoint non officiel, ou à une structure de réponse fragile, est à revalider au plus tôt.
Ensuite, adaptez : authentification, schémas, pagination, formats, droits. Même si vous ne migrez pas immédiatement toutes les intégrations vers la nouvelle API, vous devez au minimum garantir que votre module ne casse pas l’admin et ne génère pas d’erreurs en debug lors d’appels API, faute de quoi la validation Marketplace devient plus difficile.
8) Process Addons : filtrage Marketplace, compat patch-level, et stratégie de test
Côté Marketplace/UX, une bonne pratique consiste à filtrer par “PrestaShop compatibility” et à vérifier la compatibilité au niveau patch (et pas seulement “9.x”). En tant qu’éditeur, cela implique de déclarer finement vos versions supportées et de publier des mises à jour alignées sur les patchs qui corrigent des régressions.
Les guidelines qualité sont également explicites : la compatibilité “Debug mode” est exigée, avec zéro erreurs/warnings/notices en debug. Autrement dit, un module “fonctionnel” mais bruyant sera un risque de rejet et un générateur de tickets support.
Enfin, la recommandation officielle côté migration est à reprendre dans vos procédures : “We recommend testing this version on a copy of your shop or using a clean installation.” Action prioritaire “process” : imposer un environnement de test (clone de boutique ou installation clean) avant installation/mise à jour, puis valider les parcours clés (install/uninstall, upgrade, hooks critiques, BO/FO) avant de pousser la release Addons.
9) Industrialiser la compatibilité : automatisation (Docker + PHPStan) et contraintes de packaging
Pour tenir les délais (notamment la règle des 6 mois) et réduire le coût de maintenance, l’action la plus rentable est l’industrialisation des tests. Des approches courantes consistent à exécuter des matrices de tests via Docker (images PrestaShop + variantes PHP) et à intégrer une analyse statique type PHPStan afin de viser la compatibilité PrestaShop 9 / PHP 8.1 plus tôt, avant même les tests manuels.
Dans un contexte Addons, l’automatisation sert aussi à prouver la non-régression : installation, activation, parcours minimal, puis “debug mode: zéro bruit”. Plus vous automatisez, plus vous sécurisez vos releases patch (ce qui rejoint l’exigence de compatibilité patch-level côté Marketplace).
Enfin, un point de structure peut devenir bloquant en validation : depuis décembre 2025, le “module technical name” doit être strictement identique pour toutes les versions ZIP d’un même module. C’est une action prioritaire “packaging” à vérifier (nom du dossier, métadonnées, cohérence des archives) pour éviter un rejet Addons qui n’a rien à voir avec le code.
Pour prioriser vos actions “Compatibilité PrestaShop 9 sur Addons”, partez du plus bloquant au plus diffus : (1) PHP ≥ 8.1 et la validation runtime, (2) les ruptures Symfony 6.4, (3) les dépendances retirées du core, puis (4) l’outillage Node 20, (5) les risques UI liés à Hummingbird/Bootstrap 5.2, et (6) les intégrations impactées par la nouvelle Admin API.
Ensuite, sécurisez la distribution Marketplace : déclaration de compatibilité précise, conformité debug mode, cohérence du “technical name” dans les ZIP, et tests systématiques sur une copie/installation clean. Cette combinaison (tech + process) est ce qui réduit le plus vite les rejets Addons, les incidents post-update, et la charge support tout en respectant les contraintes de maintenance imposées par la sortie de PrestaShop 9.

