Une migration PrestaShop 9 peut échouer alors que la mise à jour du cœur semble s’être déroulée correctement : une version de PHP incompatible, un thème qui appelle encore un élément retiré ou un module qui ne fonctionne plus sur une page du back-office suffisent à perturber la boutique. Pour sécuriser la migration PrestaShop 9, il faut donc traiter le serveur, le cœur, le thème et chaque module comme un ensemble, puis vérifier les parcours réellement utilisés avant de basculer la boutique en production.
La méthode la plus fiable consiste à cloner le site, vérifier la version de PHP, tester les extensions et le thème, mettre à niveau le cœur en préproduction, puis retester le front-office, le back-office, le paiement, la livraison et la recherche. Cette démarche demande plus de préparation qu’une mise à jour directe, mais elle permet de localiser les régressions avant qu’elles affectent les commandes ou les opérations quotidiennes.
Sommaire
Migration PrestaShop 9 : la réponse courte et l’ordre des contrôles
Pour migrer vers PrestaShop 9, créez d’abord une copie de la boutique et de sa base de données dans un environnement de préproduction. Vérifiez que l’environnement respecte les exigences de la version cible, notamment PHP 8.1 au minimum et jusqu’à PHP 8.4 selon les informations disponibles. Confirmez ensuite la compatibilité du thème et de chaque module, mettez à niveau le cœur sur la copie, puis testez les parcours essentiels avant de planifier le déploiement.
En bref : clonez, vérifiez PHP, contrôlez les modules et le thème, mettez à niveau PrestaShop en préproduction, videz le cache après un changement de PHP et testez les fonctions métier. Ne considérez pas une migration comme validée tant qu’un simple affichage de la page d’accueil est votre seul test réussi.
Le séquencement compte. Modifier simultanément PHP, le cœur, le thème et plusieurs modules complique l’identification de la cause d’une erreur. Si une page cesse de fonctionner après plusieurs changements groupés, il devient plus difficile de savoir s’il faut examiner le code du thème, une extension, la configuration du serveur ou une interaction entre eux.
La documentation PrestaShop rappelle que toutes les couches d’une boutique sont concernées par une mise à niveau : serveur, PHP, cœur PrestaShop, thème et modules. En pratique, il est utile de conserver une trace de l’état initial et des changements effectués. Cette traçabilité rend les essais répétables et fournit aux développeurs ou à l’agence un contexte exploitable lorsqu’une régression apparaît.
Préparer l’environnement de migration et vérifier PHP
Avant toute modification, établissez un point de départ reproductible. La copie de préproduction doit représenter suffisamment fidèlement la boutique en production pour que les tests soient utiles : version du cœur, configuration, thème, modules, données nécessaires et comportements métier. Une copie qui ne contient pas les modules de paiement ou les règles de livraison réelles peut valider l’apparence générale tout en manquant les risques les plus importants.
Créer une préproduction exploitable
La préproduction sert à expérimenter sans exposer les clients à une intervention en cours. Les conditions officielles de support recommandent un environnement de test ou de préproduction pour les interventions. La boutique de test doit également être isolée des opérations réelles : vérifiez notamment que les essais de commande n’envoient pas de confirmations à des clients et ne déclenchent pas de transactions ou d’expéditions réelles.
- Copiez les fichiers et la base de données selon une procédure contrôlée, puis vérifiez que la copie démarre avant de commencer la mise à niveau.
- Repérez les paramètres d’environnement qui doivent différer de la production, par exemple les identifiants de services externes ou les adresses de notification.
- Notez les versions de PHP, de PrestaShop, du thème et des modules installés afin de pouvoir comparer l’état de départ et l’état cible.
- Conservez une sauvegarde exploitable des fichiers et de la base avant de modifier PHP ou le cœur.
Une sauvegarde n’est utile que si elle peut être restaurée. Lorsque le processus le permet, vérifiez la procédure de restauration dans un contexte de test et identifiez qui peut la déclencher. Cela ne garantit pas à lui seul le succès d’une migration, mais évite de découvrir au moment d’une difficulté que la copie de secours est incomplète ou inaccessible.
Choisir une version de PHP compatible sans devancer les tests
PrestaShop 9 exige PHP 8.1 au minimum et prend en charge jusqu’à PHP 8.4 selon les informations fournies. La page des exigences serveur précise que la table de compatibilité dépend de la version de PrestaShop concernée. Elle indique également que PHP 7.2.5 à 8.0 n’est pas recommandé, ces versions n’étant plus maintenues. Il faut donc vérifier la matrice applicable à la version exacte visée, plutôt que de reprendre une configuration historique ou une recommandation conçue pour une autre version.
Ne changez pas la version de PHP en production simplement parce qu’elle figure dans la plage annoncée pour PrestaShop 9. L’éditeur conseille de vérifier la compatibilité du thème et des modules avant de modifier PHP et de tester d’abord en préproduction. Le code personnalisé, les bibliothèques du serveur et les services externes peuvent aussi peser dans la décision ; la compatibilité du cœur ne vaut pas confirmation automatique de la compatibilité de chaque composant installé.
- Relevez la version PHP actuellement utilisée par la boutique et celle prévue pour la cible.
- Consultez les exigences serveur correspondant précisément à la version de PrestaShop retenue.
- Vérifiez les exigences des modules, du thème et des développements spécifiques avant le changement.
- Appliquez le changement à la copie, puis contrôlez les journaux, les pages administratives et les parcours de vente.
- Après un changement de PHP, videz le cache PrestaShop et reprenez les tests afin d’éviter de confondre un cache obsolète avec un défaut persistant.
La compatibilité annoncée avec PHP 8.4 ne signifie pas qu’il faut nécessairement choisir cette version pour chaque projet. Le choix doit rester cohérent avec les exigences des extensions installées et avec les résultats des essais. Si un composant critique ne fonctionne pas sur la version PHP envisagée, il vaut mieux résoudre cette dépendance ou revoir le calendrier que de considérer la version du cœur comme le seul critère.
Auditer les modules et le thème avant la mise à niveau du cœur
Le contrôle des extensions et du thème est souvent le travail le plus détaillé de la migration. Une boutique peut cumuler des modules du catalogue, des développements sur mesure et des fonctions intégrées au thème. La présence d’un module dans le back-office ne prouve pas qu’il est compatible avec PrestaShop 9, et un thème qui s’affiche sur la page d’accueil peut encore échouer dans une page produit, le panier ou une page migrée vers Symfony.
Établir un inventaire orienté risque
Commencez par classer les composants selon leur rôle et leur impact en cas d’échec. Le module de paiement, les règles de livraison, la gestion des taxes ou le traitement des commandes méritent une vérification prioritaire par rapport à une fonction secondaire rarement utilisée. Ce classement ne remplace pas les tests des composants moins critiques : il aide à répartir l’effort et à décider ce qui doit être résolu avant le basculement.
- Fonctions commerciales : paiement, livraison, promotions, prix, taxes et création de commande.
- Fonctions de gestion : synchronisation de stock, facturation, export, ERP ou autres intégrations métier présentes dans la boutique.
- Affichage et contenu : thème, constructeur de pages, blocs, widgets, recherche et navigation.
- Fonctions techniques : cache, sécurité, journalisation, tâches planifiées et modules qui modifient le comportement du cœur.
Pour chaque élément, relevez son nom, sa version, son origine, sa fonction, son statut de maintenance connu et l’information de compatibilité disponible. En cas de module développé sur mesure, attribuez explicitement la responsabilité de l’audit à une personne ou à une équipe. Une extension sans propriétaire identifié peut devenir un point de blocage, car personne ne sait confirmer son comportement attendu ni préparer un correctif.
Exiger une preuve pertinente de compatibilité
Les standards de la marketplace PrestaShop exigent désormais une déclaration précise de compatibilité des modules. Les règles indiquent également qu’à partir du 1er février 2026, les soumissions de mises à jour sont rejetées si le produit n’est pas déjà compatible avec la dernière version de PrestaShop. Les conditions vendeurs précisent que tout nouveau module ou toute mise à jour soumis à partir de cette date doit être entièrement compatible avec PrestaShop V9, sous réserve d’exceptions limitées.
Ces exigences renforcent les attentes envers les fournisseurs, mais elles ne remplacent pas la validation de la boutique. Une déclaration de compatibilité ne teste pas automatiquement les personnalisations locales, les autres modules actifs, le thème ni les connexions à des services externes. Demandez au fournisseur quelle version de module a été testée, quelles fonctions sont couvertes et si une mise à jour doit être installée avant le passage du cœur.
La documentation de PrestaShop Validator montre également une évolution des contrôles liés à v9 : des vérifications « Errors » détectent des variables Smarty supprimées dans les templates v9, tandis que des vérifications de compatibilité s’appuient sur PHPStan pour PS v9 beta. C’est un signal utile : la validation automatisée s’intéresse à la fois aux ruptures de templates et à l’analyse statique du code. Ces outils peuvent révéler des problèmes, mais ne remplacent pas les essais fonctionnels dans la boutique.
Examiner les zones sensibles du thème
Le thème doit être testé comme un composant fonctionnel, pas seulement comme une couche graphique. Vérifiez les pages produit, les catégories, le panier, les étapes de commande, les pages de compte client et les éléments communs tels que les menus ou les blocs de navigation. Contrôlez aussi les variantes de produits, les messages de validation et les états d’erreur : un parcours réussi avec un seul produit simple ne couvre pas toutes les interactions de la boutique.
Les évolutions de PrestaShop 9 comprennent davantage de pages migrées vers Symfony et des améliorations du cœur. La compatibilité avec les pages du cœur migrées est donc susceptible d’évoluer au fil des versions v9. Il est prudent de tester le thème et ses personnalisations sur la version cible précise, plutôt que de déduire leur fonctionnement d’un test réalisé sur une version antérieure de la branche.
Mettre à niveau le cœur et traiter les risques de Symfony
L’introduction officielle de PrestaShop 9 met en avant un changement technique majeur autour de Symfony 6.4, la compatibilité PHP 8.1 à 8.4 et une nouvelle Admin API. Ces évolutions sont importantes pour la plateforme, mais elles touchent aussi les intégrations qui s’appuient sur les contrôleurs, les hooks, les templates ou des comportements internes du cœur. Une mise à niveau peut donc nécessiter une vérification au-delà de la simple installation des fichiers.
Les mises à jour mensuelles publiées au milieu de 2026 décrivent la poursuite du travail de migration Symfony. Cela signifie qu’un module qui intervient sur des pages administratives ou des parcours historiques doit être testé sur les pages concernées, et pas seulement activé pour vérifier que le back-office s’ouvre. Les overrides et le code qui dépend d’implémentations internes méritent une attention particulière, car leur stabilité ne peut pas être présumée à partir du seul statut « installé ».
Une séquence contrôlée, avec un point de décision à chaque étape
- Reproduire l’état initial : confirmer que la copie fonctionne et consigner les symptômes préexistants, pour ne pas attribuer à la migration un défaut déjà présent.
- Stabiliser l’environnement : régler PHP selon les exigences de la version cible et les compatibilités vérifiées en préproduction.
- Préparer les composants : installer ou mettre à jour les versions compatibles du thème et des modules, en suivant les recommandations de leurs fournisseurs.
- Mettre à niveau le cœur : exécuter la procédure retenue sur la copie et vérifier immédiatement son résultat, ses journaux et les fonctions d’administration.
- Isoler les régressions : si une fonction échoue, reproduire le problème et réduire les changements variables avant d’appliquer un correctif.
- Rejouer les tests métier : valider les parcours de bout en bout avant toute décision de déploiement.
Si le projet utilise l’Admin API ou des intégrations qui communiquent avec le back-office, ajoutez-les à l’audit plutôt que de supposer qu’elles sont couvertes par les tests du front-office. Vérifiez les opérations attendues par l’intégration, les droits utilisés et le traitement des réponses. Les faits disponibles confirment l’arrivée d’une nouvelle Admin API, mais ne suffisent pas à déterminer quelles adaptations particulières votre intégration nécessite : ce point doit être vérifié à partir de son implémentation et de la documentation applicable.
Un avantage de la préproduction est de pouvoir comparer le comportement avant et après chaque étape. Son inconvénient est qu’elle ne reproduit pas toujours toutes les conditions de production, notamment la charge, les services externes ou les données qui changent continuellement. Notez ces limites dans le plan de test et prévoyez un contrôle ciblé après déploiement, sans transformer la production en environnement d’expérimentation.
Tests essentiels : du front-office aux commandes et à l’indexation
La recette doit confirmer que les fonctionnalités qui font vivre la boutique fonctionnent, et pas uniquement que la mise à niveau s’est terminée sans erreur visible. La séquence de migration recommandée est de tester le front-office et le back-office, le paiement, la livraison, puis l’indexation et la recherche après la mise à niveau du cœur. Chaque boutique doit adapter les scénarios aux modules et règles réellement en service.
Front-office et parcours client
Parcourez les principales pages avec des cas représentatifs. Vérifiez la navigation, les catégories, les pages produit, les images, les déclinaisons, les prix et les messages affichés. Ajoutez au panier un produit avec les options courantes, modifiez la quantité, supprimez un article, puis poursuivez le parcours de commande. Répétez les essais avec les règles de promotion ou les modes de livraison qui sont importants pour l’activité.
- Contrôlez l’affichage sur les gabarits principaux, y compris les pages qui utilisent des modules de contenu.
- Vérifiez les formulaires, les validations, les erreurs attendues et les messages de confirmation.
- Testez le panier avec les combinaisons de produits et de règles pertinentes pour votre boutique.
- Confirmez que les liens, la navigation et la recherche conduisent à des résultats cohérents.
Back-office, paiement et livraison
Dans le back-office, ouvrez les pages utilisées par les équipes, notamment celles qui gèrent les commandes, les produits, les clients et les paramètres des modules concernés. Testez les opérations réellement effectuées par les utilisateurs : consulter une commande, changer son état, éditer une fiche ou déclencher une action d’un module. Une page d’administration peut sembler correctement chargée tout en présentant un bouton inopérant ou une action qui échoue lorsqu’elle est appelée.
Le paiement doit être essayé dans un environnement adapté, avec des moyens de test lorsque le fournisseur en propose. Vérifiez les états attendus d’une commande : création, paiement accepté ou refusé, retour depuis le prestataire et mise à jour du statut. Pour la livraison, contrôlez les transporteurs disponibles, les frais calculés, les restrictions et les informations visibles dans la commande. Ne déclenchez pas de paiements réels ni d’expéditions réelles pendant les tests de préproduction.
Recherche, indexation et comportement après cache
Après la mise à niveau, testez la recherche de produits et la navigation par catégories, puis vérifiez l’indexation si la boutique s’appuie sur elle. Une page de résultats vide peut venir d’un problème distinct du thème ou du paiement. Pour éviter de confondre plusieurs causes, consignez les requêtes testées, les produits attendus et le résultat observé.
Le Centre d’aide recommande de vider le cache PrestaShop après un changement de PHP. Appliquez cette étape après le changement, puis refaites les contrôles pertinents : les classes ou templates conservés en cache peuvent donner une image trompeuse de l’état réel. Si un défaut apparaît uniquement avant le nettoyage du cache ou persiste après celui-ci, consignez précisément ces deux observations pour faciliter le diagnostic.
Consigner des résultats qui permettent de décider
Un test est plus utile lorsqu’il possède un résultat attendu clair. Pour chaque scénario, notez le prérequis, les actions, le résultat obtenu et le statut. Si un scénario échoue, ajoutez l’étape précise où le comportement diverge et les éléments de diagnostic disponibles. Cette discipline évite les validations vagues du type « le checkout a l’air correct » et aide à distinguer un défaut bloquant d’une amélioration non essentielle.
Définissez des critères de décision avant la recette : quelles erreurs interdisent le déploiement, quels défauts peuvent être corrigés dans une intervention ultérieure et qui valide les fonctions commerciales. Il n’existe pas de liste universelle adaptée à toutes les boutiques ; les exigences d’un site avec des connexions de stock complexes diffèrent de celles d’une boutique dont les commandes sont traitées autrement. La bonne couverture est celle qui correspond aux risques et aux processus réels du marchand.
Planifier le déploiement, le retour arrière et le suivi
Une préproduction validée réduit le risque, sans rendre le déploiement sans risque. Entre les tests et le basculement, des commandes, des clients ou des stocks peuvent évoluer. Préparez donc une procédure qui tient compte de la synchronisation des données et de la durée d’indisponibilité éventuelle, plutôt que de recopier mécaniquement la base de test sur la production.
Avant l’intervention, définissez les responsabilités, les étapes, les contrôles après mise en ligne et la marche à suivre en cas de blocage. Vérifiez que les sauvegardes de la boutique et de sa base sont disponibles avant tout changement de PHP, conformément au conseil du Centre d’aide. Le plan doit préciser qui décide de poursuivre ou de revenir en arrière, ainsi que les conditions qui déclenchent cette décision.
Liste de contrôle avant production
- La préproduction a été testée avec la version cible exacte de PrestaShop et la version de PHP retenue.
- Les modules et le thème critiques disposent d’une compatibilité vérifiée ou d’un plan de remplacement ou de correction approuvé.
- Les parcours de commande, paiement, livraison, administration, recherche et indexation ont été testés selon les fonctions du site.
- Les sauvegardes sont récentes, accessibles et associées à une procédure de restauration comprise par l’équipe.
- Les changements et les personnalisations ont un responsable identifiable pour le suivi post-migration.
Après le déploiement, surveillez les fonctions qui touchent directement les commandes et les opérations internes. Vérifiez les erreurs observables, les retours des équipes et les comportements des intégrations. Une page d’accueil qui s’affiche correctement n’est pas un indicateur suffisant de la santé de l’ensemble du système. En cas de défaut, comparez les observations avec les tests de préproduction et suivez le plan de retour arrière plutôt que d’enchaîner des modifications non documentées.
La fenêtre de support officielle est un autre élément de planification : les conditions de support indiquent que celui-ci se concentre sur les deux versions majeures les plus récentes. Cette information ne permet pas de déduire le niveau de support d’un module tiers ou d’une personnalisation, mais elle rappelle l’intérêt de ne pas repousser indéfiniment l’évaluation des versions et des dépendances.
Fonctions v9, évolution de la branche et choix du bon moment
PrestaShop 9.2 est indiquée comme stable au 30 septembre 2026. Cette version ajoute notamment un One Page Checkout natif, Ask AI et Extra Properties. Les notes de version demandent explicitement aux marchands de vérifier la compatibilité des modules et des thèmes avant la mise à niveau. Ces nouveautés peuvent rendre l’évolution intéressante, mais elles ne dispensent pas d’évaluer les modules déjà utilisés ni de vérifier si une fonction existante est remplacée ou affectée.
Une fonctionnalité native peut simplifier une architecture dans certains cas, mais sa présence ne signifie pas que tous les besoins couverts par un module tiers sont identiques. Comparez les fonctions réellement utilisées : règles, intégrations, configuration, données et processus de gestion. Évitez de désactiver une extension critique au seul motif qu’un nom de fonctionnalité similaire apparaît dans la version cible ; faites d’abord un essai représentatif et confirmez le comportement attendu.
PrestaShop 9.1.5, publiée le 18 août 2026 selon les informations fournies, comprend environ une centaine de corrections, un nouveau hook actionNotFound et un helper de thème qui vérifie la compatibilité du framework. Cette version inclut aussi des tests d’intégration pour ModuleHtmlAuthorizationChecker, montrant que la couverture automatisée continue de s’étendre autour de la sécurité et du comportement des modules. Ces évolutions sont des éléments à examiner dans les notes de version, non une garantie que chaque boutique ou module est sans régression.
Le projet publie aussi des appels à tester les versions bêta et RC de 9.2. Cela montre que la validation anticipée est encouragée avant les versions stables. Pour les équipes qui disposent d’un environnement technique et du temps nécessaire, tester une préversion peut permettre de signaler des problèmes ou de préparer les adaptations. En contrepartie, une bêta ou une RC ne doit pas être traitée comme une cible de production stable ; la recette de mise en production doit porter sur la version stable effectivement choisie.
Enfin, la feuille de route 2026 mentionne des travaux liés à PHP 8.5 et à Symfony 6.4 LTS. Pour les nouveaux modules et développements, l’enjeu pratique est d’éviter les hypothèses de runtime obsolètes et les dépendances inutiles à des comportements anciens. Cela ne signifie pas qu’il faille adopter immédiatement toute version future mentionnée dans une feuille de route : les choix doivent suivre les versions officiellement compatibles et les tests disponibles pour la cible du projet.
Questions fréquentes sur la migration PrestaShop 9
Quelle version de PHP faut-il pour PrestaShop 9 ?
Les informations de compatibilité fournies indiquent PHP 8.1 au minimum et une prise en charge jusqu’à PHP 8.4. Vérifiez toujours la table correspondant à la version exacte de PrestaShop visée, ainsi que les exigences des modules et du thème. Conseil pratique : testez le changement de PHP sur la copie de préproduction, sauvegardez les fichiers et la base avant l’intervention et videz le cache après le changement.
Peut-on mettre à niveau PrestaShop sans environnement de test ?
La recommandation officielle est d’utiliser un environnement de test ou de préproduction pour les interventions. Une mise à niveau directe réduit la possibilité de repérer et corriger les incompatibilités avant qu’elles affectent la boutique. Conseil pratique : si vous ne disposez pas encore d’une préproduction, faites-en la préparation une étape du projet plutôt que de prendre l’absence de copie comme une raison de sauter la recette.
Comment savoir si un module est compatible avec PrestaShop 9 ?
Consultez la déclaration de compatibilité et les informations du fournisseur pour la version précise du module, puis testez les fonctions utilisées dans votre propre boutique. Les standards de la marketplace exigent une déclaration de compatibilité précise, mais les personnalisations et les interactions avec les autres composants nécessitent une validation locale. Conseil pratique : priorisez les modules de paiement, livraison, commande et intégration métier, puis consignez le résultat de chaque scénario de test.
Que faut-il tester après la mise à niveau du cœur ?
Testez au minimum le front-office, le back-office, la commande, le paiement, la livraison, la recherche et l’indexation, en ajoutant les fonctions propres à la boutique. Contrôlez aussi le thème et les modules qui interviennent sur les pages migrées vers Symfony. Conseil pratique : écrivez des scénarios avec un résultat attendu et rejouez-les après avoir vidé le cache si PHP a changé.
Faut-il passer directement à PrestaShop 9.2 ?
La version 9.2 est indiquée comme stable au 30 septembre 2026 et apporte plusieurs nouveautés, mais ses notes demandent de vérifier la compatibilité des thèmes et modules. La décision dépend de la cible retenue, des dépendances du site et de la valeur des fonctions apportées pour la boutique. Conseil pratique : comparez d’abord les versions et les fonctions dont vous dépendez, puis validez la version choisie en préproduction avant d’organiser le déploiement.
Références officielles à consulter
- Introduction officielle à PrestaShop 9 : évolutions techniques, Symfony 6.4, compatibilité PHP et Admin API.
- Page des exigences serveur PrestaShop 9 et tableau de compatibilité des versions de PHP.
- Centre d’aide PrestaShop : recommandations de compatibilité avant changement de PHP, sauvegarde, nettoyage du cache et préparation des mises à niveau.
- Conditions officielles de support : environnement de test recommandé et périmètre de support des versions majeures.
- Standards de la marketplace PrestaShop et conditions vendeurs concernant la déclaration de compatibilité des modules.
- Historique de PrestaShop Validator : contrôles des templates Smarty v9 et compatibilité PHPStan.
- Notes de version de PrestaShop 9.1.5 et 9.2, actualités mensuelles et feuille de route 2026.
Une migration PrestaShop 9 réussie repose moins sur un clic de mise à jour que sur une séquence vérifiable : environnement représentatif, PHP contrôlé, modules et thème audités, cœur mis à niveau en préproduction et tests métier documentés. Les contraintes et les risques varient selon les personnalisations et les intégrations ; les décisions doivent donc s’appuyer sur les exigences de la version cible et sur le comportement observé de la boutique.
Avant de planifier le basculement, établissez l’inventaire des composants, attribuez les vérifications à leurs responsables et définissez les critères de validation et de retour arrière. Vous disposerez ainsi d’une décision de migration fondée sur des tests concrets, plutôt que sur la seule apparence du site après l’installation.
