Avec PrestaShop 9, la gestion des appels HTTP entre dans une nouvelle phase : Guzzle n’est plus inclus par défaut. Cette décision, annoncée le 20/03/2025 comme un breaking change (« PrestaShop 9 no longer includes Guzzle by default »), impacte directement de nombreux modules qui s’appuyaient implicitement sur la présence de guzzlehttp/guzzle dans l’écosystème.
La trajectoire est claire : la recommandation officielle est de migrer vers le client HTTP de Symfony (« Use Symfony HTTP client (recommended) »), qui est déjà intégré à PrestaShop depuis la version 1.7.7. Cela ouvre la porte à une migration progressive, y compris pour des modules visant encore PS 1.7/8, tout en préparant une compatibilité saine avec un PrestaShop 9 basé sur Symfony 6.4 (LTS).
1) Pourquoi Guzzle disparaît de PrestaShop 9 (et pourquoi c’est un vrai breaking change)
Les DevDocs de PrestaShop 9 listent explicitement guzzlehttp/guzzle dans le tableau des « Removed dependencies », avec la mention « Replaced by Symfony HTTP client in the core ». Autrement dit, l’hypothèse « Guzzle est disponible » n’est plus valide en PS9, même si elle l’a été de facto pendant des années via les dépendances du cœur.
Les raisons officielles (20/03/2025) pointent principalement les conflits de dépendances. Un cas classique : l’upgrade de Guzzle 5 vers 7 a été une source de frictions sur PrestaShop 8, où différents modules pouvaient réclamer des versions incompatibles, générant des erreurs de résolution Composer et des comportements imprévisibles en production.
PrestaShop justifie aussi la suppression par un constat d’usage : Guzzle serait « largely unused » dans le core. Le cœur ayant réduit ses dépendances directes à Guzzle, le maintenir « par défaut » devient un coût (risque de conflits + maintenance) sans bénéfice proportionné, surtout dans le contexte d’un upgrade majeur vers Symfony 6.4 qui impose déjà des ruptures d’API et de conventions.
2) La recommandation officielle : basculer sur Symfony HttpClient
La position publique est sans ambiguïté (20/03/2025) : « Use Symfony HTTP client (recommended) ». Le composant Symfony HttpClient est la voie privilégiée pour standardiser les appels HTTP côté PrestaShop 9, et il bénéficie d’une documentation officielle solide (Symfony “HttpClient Component”).
Concrètement, l’API est simple : le point d’entrée typique est HttpClient::create puis ->request. Ce modèle favorise des appels explicites, une gestion unifiée des options (ers, timeout, proxy…), et des réponses manipulables de manière cohérente dans l’univers Symfony.
Autre avantage essentiel pour l’écosystème PrestaShop : ce client est déjà « integrated into PrestaShop since version 1.7.7 » (fait rappelé le 20/03/2025). Pour un éditeur de module, cela signifie que migrer vers HttpClient peut améliorer la compatibilité multi-versions, au lieu d’être un changement exclusivement « PS9 ».
3) Impacts concrets pour les modules : ce qui casse et ce qu’il faut auditer
Le premier impact est immédiat : si votre module instancie directement GuzzleHttpClient ou attend la présence de classes Guzzle via l’autoload du marchand, PrestaShop 9 peut déclencher une erreur fatale (Class not found) puisque Guzzle n’est plus présent par défaut.
Le second impact est plus insidieux : même si votre module embarque une partie de l’écosystème Guzzle (ou des libs qui dépendent de Guzzle), vous pouvez introduire des collisions de versions entre modules. C’est précisément le scénario que PrestaShop cherche à réduire : des dépendances partagées mais non alignées entre extensions.
Enfin, il faut aussi auditer les usages indirects, notamment ceux liés au « circuit-breaker ». Historiquement, Guzzle pouvait être utilisé via la bibliothèque prestashop/circuit-breaker. Le plan annoncé (issues GitHub, milestone 9.0.0, 07/06/2023) est de refactorer vers symfony/http-client puis de retirer Guzzle des dépendances, ce qui peut changer le comportement de résilience réseau si votre module s’adosse à ces mécanismes.
4) Traduire un appel Guzzle en HttpClient Symfony : mapping pratique
En Guzzle, on pense souvent en termes de client + options, puis on récupère un via un stream. Avec Symfony HttpClient, on envoie une requête et on récupère une réponse dont on peut lire le contenu (par exemple via ->getContent) et le code status (via ->getStatusCode), selon le style que vous adoptez.
L’exemple recommandé par PrestaShop (20/03/2025) illustre l’intention : HttpClient::create->request. Cela encourage un code plus uniforme dans l’écosystème Symfony/PrestaShop 9, et réduit la dépendance implicite à un client tiers non fourni par défaut.
Lors de la migration, pensez à cartographier : timeouts (connexion vs total), gestion des erreurs (exceptions vs codes), redirections, et formats (JSON). Un module qui utilisait des middlewares Guzzle (retry, logging, handler stack) devra reposer ces préoccupations autrement : soit par du code applicatif, soit par des abstractions (voir section sur les contrats/interop).
5) Stratégie multi-versions : fallback Symfony HttpClient puis Guzzle
PrestaShop propose explicitement une stratégie « multi-versions » (20/03/2025) : utiliser Symfony HttpClient quand la version le permet, sinon retomber sur Guzzle. L’exemple donné suit l’idée : if (_PS_VERSION_ >= 1.7.7) Symfony HttpClient else Guzzle.
Cette approche est utile si votre module supporte encore des boutiques anciennes (par exemple 1.6 / début 1.7). Elle permet d’introduire HttpClient sans casser l’historique, tout en évitant de dépendre du fait que PrestaShop embarque Guzzle (hypothèse désormais fausse en PS9).
Attention toutefois : le fallback implique que vous testiez deux implémentations et donc deux comportements réseau. Pour limiter les écarts, isolez l’HTTP derrière une interface interne à votre module (par exemple MyHttpClientInterface) et fournissez deux adaptateurs, afin de garder le reste du code identique.
6) Ne pas recoupler votre module : abstractions, Contracts, PSR-18 et HTTPlug
Les docs Symfony (consultées fin 2025) recommandent, pour les bibliothèques et code réutilisable, de « décorréler l’implémentation en codant contre des abstractions ». Dans un module PrestaShop, c’est souvent la meilleure manière d’éviter d’être prisonnier d’un client particulier (Guzzle aujourd’hui, autre chose demain).
Le composant HttpClient est interopérable : compatible Symfony Contracts, PSR-18 et HTTPlug v1/v2, et peut s’appuyer sur des streams PHP. Cette interop est précieuse si vous visez un module agnostique (ex. partage de code avec un autre framework), ou si vous souhaitez laisser la boutique choisir l’implémentation.
Un pattern robuste consiste à exposer une interface de haut niveau (ex. RemoteApiClient) dans votre module, puis à l’implémenter via Symfony HttpClient en environnement PrestaShop 9. Ainsi, vous limitez la surface de changement, et vous pouvez même substituer un mock/fake en tests sans dépendre des détails du transport.
7) DI Symfony, legacy, et piste “ClientFactory” : aligner avec l’architecture PS9
Côté core, l’objectif déclaré (issue GitHub 07/06/2023, milestone 9.0.0) était de « drop all the usages of guzzle currently used in the core » et de remplacer par Symfony HTTPClient. Dans un environnement Symfony, l’usage attendu est un client fourni comme service et injecté via le conteneur (DI), ce qui favorise la configuration centralisée (timeouts, proxy, instrumentation).
La discussion d’architecture mentionnait aussi l’idée d’introduire une interface « core » pour le client HTTP afin de ne pas coupler directement le core à Symfony. Ce point est intéressant pour les modules : s’il existe (ou émerge) une abstraction côté PrestaShop, vous aurez intérêt à l’utiliser plutôt que d’appeler directement une implémentation concrète partout.
Dans le legacy, une difficulté récurrente est « comment obtenir un client » hors DI. La proposition évoquait un besoin potentiel de ClientFactory. Pour vos modules, vous pouvez reproduire l’idée : une petite fabrique qui récupère le service HttpClient si disponible (Symfony), sinon instancie un fallback (ou une implémentation custom), tout en gardant un point d’entrée unique.
8) Alternatives et anti-patterns : embarquer Guzzle, client custom, et risques de vendors
Les échanges côté core (07/06/2023) précisent l’attendu pour les modules : si un module a besoin de Guzzle, il peut soit migrer (recommandé), soit embarquer Guzzle comme dépendance du module. Néanmoins, la documentation récente (20/03/2025) met en avant un anti-pattern : « Forcefully include Guzzle in my module’s vendors (not recommended) ».
Pourquoi « not recommended » ? Parce que forcer l’inclusion peut provoquer des conflits entre modules (classes dupliquées, versions divergentes, autoload ambigu), exactement le problème que PS9 veut éviter. Dans les boutiques avec beaucoup d’extensions, ces conflits sont parmi les plus coûteux à diagnostiquer.
Une alternative mise en avant (20/03/2025) est de créer son propre client HTTP pour éviter les conflits de vendors, à l’image du client custom cité dans le module EventBus. L’idée n’est pas de réécrire un stack HTTP complet, mais d’encapsuler un transport stable (Symfony HttpClient en priorité) derrière une couche maîtrisée par le module, en réduisant au maximum les dépendances imposées au marchand.
La migration de Guzzle vers Symfony HttpClient n’est pas seulement un remplacement d’API : c’est un alignement avec la direction de PrestaShop 9, qui retire Guzzle par défaut et s’appuie sur une base Symfony 6.4 (LTS). En pratique, cela implique d’auditer vos dépendances, d’identifier les usages directs/indirects de Guzzle, et de planifier une transition qui respecte vos contraintes de compatibilité.
La voie la plus sûre est de suivre la recommandation officielle : adopter Symfony HttpClient, idéalement derrière une abstraction (Contracts/PSR-18/HTTPlug ou interface interne), et prévoir une stratégie multi-versions si votre module cible encore des PrestaShop antérieurs. Vous réduisez ainsi les risques de conflits entre modules, vous simplifiez la maintenance, et vous préparez votre code aux évolutions futures du core.

