Passer un module à la version 9 ne se résume pas à corriger quelques warnings : c’est un changement de socle technique et de dépendances qui peut casser des fonctionnalités en production. La meilleure manière de réduire le risque est de transformer la compatibilité en un objet mesurable, vérifié en continu par des tests automatisés et une intégration continue (CI).
Les documentations PrestaShop insistent sur le fait que créer des tests fait partie du cycle de vie d’un module : on passe moins de temps en relecture, on évite les vérifications redondantes, et on améliore la qualité du code. L’objectif de cet article est de proposer une stratégie concrète pour mettre en place des tests automatisés garantissant la compatibilité des modules avec la version 9, en s’appuyant aussi sur des pratiques éprouvées dans d’autres écosystèmes (TYPO3, Drupal).
1) Définir le périmètre de compatibilité PrestaShop 9 à couvrir par vos tests
Avant d’écrire le moindre test, il faut traduire “compatible PrestaShop 9” en exigences vérifiables. PrestaShop 9 impose notamment PHP ≥ 8.1, Node ≥ 20, ainsi qu’une migration vers Symfony 6.4, avec des breaking changes qui ont un impact direct sur les modules. Votre CI doit donc pouvoir exécuter le module dans cet environnement cible, pas seulement “compiler” du code.
Une première couche de tests doit valider l’installabilité et l’exécution de base : installation/désinstallation du module, chargement des pages d’administration concernées, exécution d’un hook critique, et génération d’une réponse HTTP sans erreur. Ce socle permet de détecter rapidement les erreurs fatales PHP 8.1, les incompatibilités Symfony, ou les appels à des services supprimés.
Enfin, la compatibilité ne se limite pas au runtime : elle inclut la chaîne de build (assets, back-office, front). Node ≥ 20 signifie que vos scripts (build, lint, bundling) doivent tourner sans hacks. Intégrer ces vérifications dans CI évite d’arriver “à la fin” avec une dette de tooling difficile à résorber.
2) Mettre en place une matrice CI multi-versions (et la lancer tôt)
La PSDevCon (article 2025) met en avant un workflow d’analyse et de test automatique de compatibilité sur plusieurs versions (1.6.1.23, 1.7.8, 8.1.7, 9.0.0-alpha.1). L’idée est simple : au lieu d’avoir une “pipeline” unique, vous exécutez une matrice de jobs, un par version de PrestaShop (et éventuellement par version PHP), afin de détecter immédiatement ce qui casse où.
Cette approche est également un principe classique dans d’autres CMS. TYPO3 documente depuis longtemps les tests d’extensions en tenant compte des versions PHP supportées par TYPO3 v9 via CI, ce qui revient à formaliser la compatibilité sous forme de matrice. Le bénéfice est identique : vos tests deviennent une preuve reproductible de compatibilité, pas un ressenti.
Point clé rappelé lors de la PSDevCon : tester en fin de développement peut devenir compliqué si une section de code n’est pas rétrocompatible. Autrement dit, plus vous attendez, plus vous risquez un refactoring coûteux. La bonne pratique est d’activer la matrice CI dès les premières PR, quitte à ne couvrir au départ que quelques scénarios essentiels, puis à étendre progressivement.
3) Automatiser la détection des dépendances supprimées ou remplacées
PrestaShop 9 supprime ou remplace plusieurs dépendances historiques, et ces changements doivent être détectés automatiquement : par exemple Guzzle remplacé par Symfony HTTP Client, SwiftMailer remplacé par Symfony Mailer, etc. Un module peut “sembler” fonctionner jusqu’au moment où une branche de code appelle une dépendance devenue absente ; une simple suite de tests manuels ne passe pas forcément sur tous les chemins.
Pour sécuriser cela, combinez analyse statique et tests d’intégration. L’analyse statique (PHPStan, règles personnalisées, scans de namespaces) repère les classes obsolètes ou les packages indirects, tandis que des tests d’intégration déclenchent les cas métier (envoi d’email, appels HTTP sortants, webhooks, synchronisation) afin de vérifier le comportement réel avec Symfony Mailer/HTTP Client.
Dans l’esprit de ce qui existe ailleurs, TYPO3 v9 propose un “Extension Scanner” destiné à identifier des incompatibilités et planifier les upgrades. Même si l’outil est spécifique à TYPO3, le concept est utile : ajoutez dans votre pipeline une étape “scanner” (audit de code + dépendances) dont le rôle est de sortir une liste actionnable d’incompatibilités, au même titre que vos tests unitaires.
4) Couvrir le module par un mix de tests unitaires et fonctionnels
La documentation PrestaShop sur le testing recommande explicitement un mix de tests unitaires et fonctionnels, intégré dans une démarche CI/CD. Les unit tests sécurisent la logique pure (services, helpers, mapping, règles de prix, calculs), et sont rapides à exécuter sur chaque commit.
Les tests fonctionnels, eux, limitent les régressions de bout en bout. Ils couvrent les interactions critiques : configuration en back-office, affichage sur le front-office, déclenchement de hooks, génération de formulaires, et comportements dépendants du cœur. Dans PrestaShop 9, ce type de test est essentiel car certains changements sont “core” et impactent l’UI/les routes/le rendu.
Pour rendre le tout durable, structurez votre suite : une base “smoke tests” (rapide) pour chaque PR, et une suite plus large (plus lente) exécutée la nuit ou sur les branches de release. Cette organisation évite d’opposer vitesse et couverture, tout en garantissant une visibilité continue sur la compatibilité.
5) Valider les changements “core” par des tests de régression ciblés
Un exemple concret de changement pouvant casser des modules en 9.0 est la page produit : la nouvelle page produit devient la seule disponible, l’ancienne n’est plus accessible. Si votre module modifie, étend ou injecte du contenu dans la page produit (front ou back), vous devez valider explicitement ce scénario via des tests fonctionnels/régression.
Concrètement, écrivez des scénarios qui ouvrent une fiche produit, vérifient la présence/absence d’éléments injectés, testent la soumission d’actions (ajout au panier, variantes, personnalisation), et s’assurent que les hooks attendus sont bien appelés. Si vous utilisez des sélecteurs fragiles, préférez des attributs stables (data-*) ou des points d’extension documentés.
Ajoutez aussi des tests négatifs : vérifier qu’aucune route/ancienne page n’est supposée accessible par votre code. Cela aide à détecter les “fallbacks” implicites (liens codés en dur, redirections, templates hérités) qui, en v9, peuvent conduire à des 404 ou à des pages incohérentes.
6) Industrialiser l’analyse qualité avec PHPStan, linters et configuration par version
La PSDevCon (article 2025) donne un exemple concret d’une configuration PHPStan par version via des fichiers .neon dédiés : c’est une approche “matrix” appliquée à l’analyse statique. Le même code peut être acceptable en 8.1 mais pas en 9, ou inversement si vous conservez une compatibilité descendante ; séparer les configurations permet d’encoder ces contraintes.
En pratique, vous pouvez avoir phpstan-ps8.neon et phpstan-ps9.neon, chacun avec ses stubs, son level, et ses exclusions temporaires. L’objectif n’est pas d’exclure pour “faire passer”, mais de rendre les écarts explicites et traçables, et de réduire ces écarts au fil des versions.
En complément, appuyez-vous sur les outils généralement recommandés pour automatiser la qualité et la compatibilité (par exemple php-cs-fixer, PHPStan, etc.), comme listé dans la documentation du PrestaShop Validator. Cette standardisation rend vos résultats comparables, facilite les revues, et évite de réinventer une chaîne de contrôle ad hoc.
7) Compléter vos tests par le PrestaShop Validator et une traçabilité de compatibilité
Les tests automatisés vérifient le comportement, mais ils ne remplacent pas les exigences de conformité attendues pour la distribution. Le PrestaShop Validator est un outil de validation qui explique précisément ce que vous devez modifier pour être conforme aux exigences techniques : il est utile en complément des tests, notamment pour repérer des points “packaging” ou structurels hors du périmètre des tests.
La documentation du Validator rappelle aussi un point process important : n’oubliez pas d’indiquer avec quelles versions de PrestaShop votre module est compatible. Cette traçabilité doit être cohérente avec votre matrice CI : autrement dit, vous ne devriez déclarer “PS 9 compatible” que si un job CI PrestaShop 9 passe (tests + analyses) sur une référence donnée.
Une approche efficace consiste à faire du Validator un job de pipeline (par exemple sur la branche release), et à publier un artefact (rapport) avec les autres rapports (PHPUnit, coverage, PHPStan). Vous obtenez ainsi une chaîne d’évidence : conformité technique + compatibilité fonctionnelle + qualité de code.
8) S’inspirer des workflows communautaires (Drupal) pour sécuriser les migrations
Dans l’écosystème Drupal 9, la compatibilité est souvent liée aux dépréciations : on prépare la version majeure suivante en éliminant les API dépréciées avant la bascule. Ce principe est transposable : identifiez les points de dépréciation/rupture (Symfony 6.4, dépendances remplacées) et automatisez leur détection le plus tôt possible.
Drupal propose aussi des cadres pratiques pour tester des patches de compatibilité (modules/thèmes) : c’est une culture où la validation passe par des tests reproductibles et partagés. Pour vos modules PrestaShop, cela peut se traduire par une checklist CI imposée à chaque PR “compat v9” : unit tests, tests fonctionnels, analyse statique, et vérification des dépendances.
Enfin, des exemples GitLab CI côté Drupal montrent comment piloter des jobs via templates et variables pour multiplier les scénarios de test. Sans copier-coller, retenez l’idée : factorisez votre pipeline (templates réutilisables), et faites varier les paramètres (version PrestaShop, version PHP, flags d’analyse) pour garder une stratégie lisible et extensible.
Mettre en place des tests automatisés pour garantir la compatibilité des modules avec la version 9 revient à construire une “preuve” continue : un environnement CI conforme (PHP ≥ 8.1, Node ≥ 20, Symfony 6.4), une matrice multi-versions, des analyses pour détecter les dépendances remplacées, et des tests fonctionnels ciblant les changements de cœur (comme la nouvelle page produit).
En combinant tests unitaires + fonctionnels, analyse statique par version (ex. configurations PHPStan dédiées), et outils de conformité comme le PrestaShop Validator, vous réduisez le risque de régression, accélérez les revues, et rendez la compatibilité traçable. Le résultat n’est pas seulement un module “qui marche chez vous”, mais un module dont la compatibilité PrestaShop 9 est vérifiée, reproductible, et maintenable dans le temps.

