Si vous avez vu passer « PrestaShop 9.0.2-2.1 » et que vous vous êtes demandé pourquoi la version “ressemble à ça”, vous n’êtes pas seul. Le 16/12/2025, une publication officielle a justement été rédigée pour clarifier cette numérotation inhabituelle, dans un souci de transparence après un incident d’installation rencontré via le package téléchargé sur prestashop.com.
Ce cas est intéressant parce qu’il mêle deux sujets souvent confondus : la version du Core PrestaShop et la version du package Classic (la distribution ZIP incluant notamment des modules “bundlés”). Comprendre ce découplage aide à diagnostiquer plus vite les situations où “la version” semble changer… sans que le cœur du logiciel ait bougé.
1) Le contexte : 9.0.2, une maintenance release… et un détail qui change tout
Le 10/12/2025, PrestaShop 9.0.2 est publiée comme une release de maintenance du Core, avec des chiffres qui donnent le ton : 49 bug fixes et 118 pull requests. Sur le papier, cela ressemble à une mise à jour classique (au sens “maintenance”), centrée sur la stabilisation.
Mais cette release rappelle aussi un point clé : le ZIP “Classic” ne contient pas que le Core. Il inclut également des modules PrestaShop SA (dont PrestaShop Checkout / ps_checkout). Et il existe une alternative : un “custom ZIP” sans ces modules, justement pour les marchands ou intégrateurs qui préfèrent éviter certains composants préembarqués.
C’est là que le sujet de la numérotation devient concret : si le Core est en 9.0.2, le package Classic peut, lui, évoluer (contenu modules, versions, correctifs) indépendamment. Et c’est exactement ce qui a mené au suffixe “-2.1”.
2) L’incident qui a déclenché le “-2.1” : installation bloquée sur ps_checkout
Le signal initial est remonté publiquement par la communauté le 12/12/2025 via une issue GitHub qualifiée de critical : une installation “fresh” de PrestaShop 9.0.2 pouvait se retrouver bloquée au moment d’installer le module ps_checkout.
Le symptôme technique était explicite : l’installeur finissait par afficher une erreur SQL, citée ensuite dans la communication officielle : SQLSTATE[42S22]: Column not found: 1054 Unknown column 'mc.id' in 'on clause'. Autrement dit, une requête supposait l’existence d’un champ qui n’était pas disponible dans le contexte rencontré.
Le contournement mentionné dans l’issue était, lui aussi, très direct : “The only way to proceed is… manually unselect the module ps_checkout…”. Un workaround utile en urgence, mais pas satisfaisant à l’échelle d’une distribution “grand public” téléchargeable depuis prestashop.com.
3) La cause racine : un bug module (ps_checkout), pas un bug du Core
Le 16/12/2025, l’explication officielle tranche un point important : “The root cause was inside ps_checkout (not the PrestaShop Core)…”. Cela signifie que le cœur de PrestaShop 9.0.2 n’était pas “cassé” en soi.
Pourquoi l’installation était-elle quand même bloquée ? Parce que, dans la distribution Classic, les modules “bundlés” sont installés pendant le setup. Donc un bug dans un module embarqué peut casser le parcours d’installation et donner l’impression que “PrestaShop 9.0.2” est en cause, alors que le problème se situe dans une brique périphérique mais livrée dans le même ZIP.
Le scénario déclencheur documenté est également très spécifique : le bug apparaissait quand le pays installé utilisait une devise non supportée par PrestaShop Checkout. Dans cette situation, une requête SQL fautive était exécutée, entraînant l’échec de l’étape d’installation du module, donc un blocage global de l’installeur Classic.
4) La correction : “refresh” du package Classic sans nouvelle release du Core
Face à ce type d’incident, deux options existent : republier une version du Core (ce qui serait lourd et parfois injustifié) ou corriger la distribution (le package) qui embarque le module fautif. PrestaShop a choisi la seconde voie.
La communication officielle parle d’un “refresh” du package Classic : l’idée est de mettre à jour le ZIP Classic en intégrant une version corrigée de ps_checkout, sans publier une nouvelle release du Core. Le Core reste donc en 9.0.2, mais le “contenu du package” change.
C’est précisément ce mécanisme qui justifie une numérotation du type 9.0.2-2.1 : on veut être transparent sur le fait qu’un composant livré dans la distribution a évolué, tout en conservant l’information que le cœur logiciel n’a pas été modifié.
5) Le format officiel A.B.C-D.E : Core vs package Classic (et pourquoi ce n’est pas “bizarre”)
Le 16/12/2025, PrestaShop formalise dans un article dédié la logique de versioning : à partir de PrestaShop 9, la distribution Classic suit une convention qui sépare la version du Core de la version du contenu du package. Format annoncé : A.B.C-D.E.
Dans ce schéma, A.B.C correspond à la version du Core (par exemple 9.0.2). Et D.E</strong correspond à la version du package Classic (son contenu : modules, versions embarquées, composition du ZIP). Autrement dit, le suffixe n’est pas un “patch” au sens Core, c’est un indicateur d’évolution de la distribution.
Cette approche est cohérente avec l’idée, rappelée dans le Help Center (16/07/2025), que les versions s’inscrivent dans une logique inspirée de SemVer (semantic versioning) : on cherche à communiquer clairement la nature du changement. Ici, la sémantique est : “Core inchangé, distribution mise à jour”.
6) Interpréter “9.0.2-2.1” et lire les incréments D / E (avec la doc GitHub)
L’interprétation officielle de “9.0.2-2.1” est la suivante : 9.0.2 = version du Core, et -2.1 = mise à jour du contenu du package Classic (notamment des modules) sans changement du Core. C’est exactement le cas du correctif lié à ps_checkout.
Une documentation GitHub dédiée (10/06/2025) explique la logique en détail : “Our idea is to use a 5 number versioning: A.B.C-D.E”, et la stabilité peut être suffixée (beta, rc) comme dans l’exemple 9.0.0-1.0-beta.2. On a donc un schéma extensible qui garde l’information Core + package, plus le niveau de stabilité.
Cette même doc explicite les incréments : D augmente quand le contenu Classic change “structurellement” (ajout/retrait de module, bump minor/major), tandis que E augmente quand les modules sont bump en patch. Elle fournit aussi des exemples de transitions : 9.0.0-1.0 puis 9.0.0-1.1 (patch module), puis 9.0.0-2.0 (minor/major module). Et un exemple utile pour comprendre l’articulation avec le Core : “PrestaShop 9.0.1 is released … → 9.0.1-2.1”, montrant que le suffixe peut évoluer “autour” d’une base Core donnée.
7) Impacts pratiques pour marchands et intégrateurs : diagnostic, choix du ZIP, communication
Pour un marchand, le premier impact est la lecture correcte d’un rapport de bug : si un ticket mentionne “9.0.2-2.1”, il ne s’agit pas d’une “9.0.2.2.1” implicite, mais d’un Core 9.0.2 + un package Classic révisé. Cela évite des malentendus, notamment quand on compare deux installations “en 9.0.2” mais issues de ZIP différents.
Pour un intégrateur, cela change aussi la stratégie de reproduction : si un bug apparaît pendant l’installation, il faut identifier si l’on utilise le ZIP Classic standard (avec modules SA) ou le custom ZIP mentionné dans les release notes. Dans l’incident de décembre 2025, le problème était lié à un module bundlé : avoir la bonne distribution est donc essentiel pour reproduire (ou éviter) le problème.
Enfin, côté communication projet, ce système apporte une granularité utile : on peut corriger rapidement un incident de packaging (module embarqué) via un “refresh” et l’indiquer clairement dans le numéro. C’est un compromis entre stabilité (ne pas reversionner le Core inutilement) et transparence (signaler qu’un ZIP a changé).
Au final, “PrestaShop 9.0.2-2.1” n’est pas une bizarrerie : c’est la matérialisation d’une séparation assumée entre le Core et la distribution Classic. L’incident d’installation lié à ps_checkout (erreur SQL, scénario devise non supportée) a simplement rendu ce mécanisme visible pour beaucoup d’utilisateurs.
Retenir l’essentiel : A.B.C vous dit où en est le cœur PrestaShop, et -D.E vous dit où en est le contenu du package Classic (modules, composition, correctifs). Dans un monde où les distributions embarquent de plus en plus de composants, cette numérotation “à deux étages” devient un outil de diagnostic aussi important qu’un numéro de version lui-même.

