La récente communication officielle de PrestaShop a clarifié les interrogations autour du libellé « 9.0.2-2.1 » apposé sur le ZIP téléchargeable après la publication de la maintenance 9.0.2. L’annonce du 16 décembre 2025 est présentée comme une mise à jour de transparence : elle explique ce qui s’est passé, les changements opérés en réponse et les mesures prises pour réduire la probabilité d’un incident similaire.
Pour les marchands et les intégrateurs inquiets, il est important de distinguer le Core de la distribution Classic packagée : la mention 9.0.2-2.1 ne signifie pas une régression du Core mais une évolution du contenu Classic (modules, packing). L’équipe PrestaShop a aussi expliqué la nature du bug et les actions correctives engagées.
Sommaire
Contexte et chronologie de la publication
La version Core PrestaShop 9.0.2 a été publiée officiellement le 10 décembre 2025 et contenait 49 corrections de bugs et 118 pull requests selon les notes de release. Peu après, des installations fraîches ont rencontré des blocages signalés par la communauté.
Face à ces signalements, PrestaShop a publié le 16 décembre 2025 une mise à jour de transparence décrivant l’incident lié au package Classic et expliquant pourquoi le ZIP proposé pouvait apparaître sous la forme 9.0.2-2.1. La communication précise que « This post is not release notes. It’s a transparency update: what happened, what we changed in response, and what we’re doing to reduce the chance of a similar incident. »
Les rapports communautaires et les issues GitHub (ex. #39283, #38887) ont joué un rôle clé pour détecter et reproduire l’erreur, permettant à l’équipe de reproduire exactement le scénario fautif et d’apporter une correction ciblée.
Le bug d’installation : message d’erreur et symptômes
Lors d’une installation fraîche de PrestaShop 9.0.2, des utilisateurs ont rapporté une erreur bloquante SQL : SQLSTATE[42S22]: Column not found: 1054 Unknown column ‘mc.id’ in ‘on clause’. Ce message survenait au moment d’installer le module ps_checkout et empêchait de poursuivre sans décocher manuellement ce module.
Concrètement, l’installation se bloquait lors de l’exécution d’une requête SQL liée au module de paiement, rendant l’expérience « out-of-the-box » dégradée pour certains pays et configurations. Ces blocages ont suscité des retours sur le forum PrestaShop et des demandes de rollback vers la branche 8 de la part de certains marchands prudents.
La visibilité donnée par ces signalements a permis de concentrer l’effort de diagnostic sur le module embarqué et d’isoler un scénario particulier où la requête devenait invalide.
Diagnostic technique : le module ps_checkout en cause
Après investigation, l’équipe a identifié que la racine du problème n’était pas le Core mais le module ps_checkout. Une requête SQL défaillante dans ce module se déclenchait uniquement dans un scénario précis : lorsque la boutique était créée pour un pays utilisant une monnaie non supportée par PrestaShop Checkout.
Le bug était donc conditionnel et lié à des données de configuration (pays/monnaie) spécifiques. Le dépôt public PrestaShopCorp/ps_checkout montre d’ailleurs une activité de releases correctives (par exemple v5.0.6 début décembre 2025) et un historique de patchs accessibles publiquement.
La clarification de la cause (module packagé et non Core) est essentielle pour rassurer les équipes techniques : cela signifiait qu’une correction ciblée du module suffirait à rétablir l’installation standard.
Correctif et mise à jour du package Classic
L’équipe PrestaShop a reproduit l’incident, développé la correction dans ps_checkout et publié un package Classic « rafraîchi » incluant la version corrigée du module. L’objectif déclaré était de « restore a smooth out-of-the-box installation experience ». Les téléchargements depuis prestashop.com ont ainsi été mis à jour pour éviter que l’échec d’installation ne se reproduise.
Cette action a consisté à remplacer la version fautive du module dans l’archive Classic distribuée, sans modifier le Core 9.0.2. Ainsi, le ZIP reste étiqueté 9.0.2-2.1 pour indiquer que seul le contenu Classic a évolué (suffixe -2.1), conformément au schéma de versioning adopté depuis PrestaShop 9.
La transparence du processus , reproduction, correction, mise à jour des artefacts téléchargeables , a permis de restaurer la confiance et d’appliquer rapidement un correctif aux utilisateurs affectés.
Comprendre la numérotation A.B.C-D.E et le suffixe 9.0.2-2.1
Depuis PrestaShop 9, la distribution Classic suit un versioning A.B.C-D.E : A.B.C correspond à la version du Core (major.minor.patch) tandis que D.E décrit la version et l’évolution du contenu Classic (modules packagés, ajouts/suppressions). La documentation officielle du wiki Classic détaille ces conventions et donne des exemples concrets.
Le suffixe -2.1 sur l’archive signifie donc une mise à jour du package Classic sans changement du Core. Autrement dit, 9.0.2-2.1 = Core 9.0.2 + Classic (content) version 2.1. Ce mécanisme permet de publier des ajustements de packaging ou des mises à jour de modules sans incrémenter la version Core.
Connaître cette distinction aide à interpréter correctement les étiquettes et évite de confondre une correction de module packagé avec une régression du cœur même de PrestaShop.
Bonnes pratiques et recommandations pour les utilisateurs
Pour éviter l’impact éventuel de modules embarqués dans une distribution, PrestaShop recommande deux options selon les besoins : utiliser le ZIP « custom » (installateur sans modules PrestaShop SA) ou télécharger la Classic officielle si l’on souhaite bénéficier du packaging complet. Ces alternatives étaient mentionnées explicitement dans les notes de la release 9.0.2.
Les agences et intégrateurs peuvent tester l’installation dans des configurations locales et vérifient les modules inclus avant tout déploiement en production. Les issues et retours communautaires montrent que la vigilance collaborative a permis de détecter rapidement le problème et d’accélérer la correction.
Enfin, il est conseillé de suivre les dépôts officiels (Core et modules comme ps_checkout) pour appliquer rapidement les releases correctives et les patchs de sécurité publiés dans le courant de 2025.
En résumé, la mention PrestaShop 9.0.2-2.1 est normale et correspond à Core 9.0.2 combiné à une version 2.1 du package Classic. L’échec d’installation observé provenait d’un module packagé (ps_checkout) et non du Core, la correction a été appliquée et les téléchargements officiels mis à jour.
PrestaShop a par ailleurs annoncé un renforcement des étapes de validation QA et une meilleure couverture de tests pour réduire le risque de régressions similaires. Pour les utilisateurs, choisir entre le ZIP custom et la Classic officielle reste la meilleure façon de maîtriser l’impact des modules embarqués.
