{"id":526044,"date":"2026-02-27T13:35:53","date_gmt":"2026-02-27T13:35:53","guid":{"rendered":"https:\/\/webkul.com\/blog\/?p=526044"},"modified":"2026-02-27T13:36:01","modified_gmt":"2026-02-27T13:36:01","slug":"how-to-use-symfony-http-prestashop-9","status":"publish","type":"post","link":"https:\/\/webkul.com\/blog\/how-to-use-symfony-http-prestashop-9\/","title":{"rendered":"How to Use Symfony HTTP Client in PrestaShop 9"},"content":{"rendered":"\n

PrestaShop 9 marks a shift in architecture by officially removing Guzzle from its core dependencies. <\/p>\n\n\n\n

For years, Guzzle was the standard for HTTP communication in the PHP ecosystem. However, as PrestaShop moves on\u00a0to Symfony 6.4 LTS<\/strong>, the platform now standardizes on the native\u00a0Symfony HTTP Client<\/strong>.<\/p>\n\n\n\n

While shifting away from a familiar tool might feel disruptive at first.<\/p>\n\n\n\n

It is actually a strategic opportunity to modernize your module codebase, making it leaner, faster, and deeply integrated with Symfony’s service container.<\/p>\n\n\n\n

In this blog, we will build a complete, installable module from scratch that demonstrates exactly how to integrate external APIs the “PrestaShop 9 way<\/strong>” using Dependency Injection<\/strong> and Services<\/strong>.<\/p>\n\n\n\n

Architecture Shift: Procedural \u2192 Service-Oriented<\/h3>\n\n\n\n

The most important conceptual change in PrestaShop 9 is moving from tightly coupled, procedural code<\/strong> inside hooks to clean service-oriented architecture<\/strong> powered by Dependency Injection.<\/p>\n\n\n\n

Before PrestaShop 9:<\/strong><\/p>\n\n\n\n

In previous versions, it was common to instantiate HTTP clients directly inside hook methods or controllers. This made the code hard to test, reuse, or maintain:<\/p>\n\n\n\n

\/\/ Old approach - Business logic, HTTP calls, and error handling all mixed together\npublic function hookActionValidateOrder(array $params): void\n{\n    $client = new GuzzleHttp\\Client([\n        'base_uri' => 'https:\/\/api.shipping.com',\n        'timeout'  => 10,\n    ]);\n\n    $response = $client->post('\/shipments', [\n        'json' => ['order_id' => $params['id_order']],\n    ]);\n\n    $data = json_decode($response->getBody(), true);\n    \/\/ ... process $data\n}<\/pre>\n\n\n\n
PrestaShop 9:<\/strong><\/p>\n\n\n\n
PrestaShop 9 embraces the Service Container<\/strong> pattern. Your hook method or controllers should do one thing: delegate to a service. HTTP logic lives in a dedicated, injectable, testable service class.<\/p>\n\n\n\n
\/\/ Good: The hook delegates to a clean service\npublic function hookActionValidateOrder(array $params): void\n{\n    $container      = SymfonyContainer::getInstance();\n    $shippingService = $container->get(ShippingApiService::class);\n\n    try {\n        $shipment = $shippingService->createShipment($params['id_order']);\n        \/\/ Clean business logic only\n    } catch (ShippingException $e) {\n        $this->handleShippingError($e);\n    }\n}<\/pre>\n\n\n\n
\"servicearchitectureflow\"<\/figure>\n\n\n\n
Building the Module Step by Step<\/h2>\n\n\n\n
Let’s build\u00a0wkdailyquote<\/strong> a complete, installable module that fetches a random quote from an external API and displays it on the PrestaShop dashboard. <\/p>\n\n\n\n
Following the full PS 9 architecture: DI, services, DTOs, caching, and error handling.<\/p>\n\n\n\n
Module Location<\/strong>: Create a folder named wkdailyquote<\/strong> inside your PrestaShop \/modules\/<\/strong> directory before starting.<\/p>\n\n\n\n
Step 1: Define Composer Autoloading<\/h4>\n\n\n\n
{\n    "name": "wk\/wkdailyquote",\n    "type": "prestashop-module",\n    "require": {\n        "php": ">=8.1"\n    },\n    "autoload": {\n        "psr-4": {\n            "WkDailyQuote\\\\": "src\/"\n        }\n    },\n    "config": {\n        "prepend-autoloader": false\n    }\n}<\/pre>\n\n\n\n
Now, navigate to \/modules\/wkdailyquote\/<\/code> in your terminal and run:<\/p>\n\n\n\n
composer dump-autoload<\/pre>\n\n\n\n
Step 2: Create the Data Transfer Object (DTO)<\/h4>\n\n\n\n
A DTO provides a type-safe, validated data structure<\/strong> for the API response. Instead of working with raw arrays throughout your codebase, you pass strongly-typed objects.<\/p>\n\n\n\n
File:<\/strong> \/modules\/wkdailyquote\/src\/DTO\/Quote.php<\/code><\/p>\n\n\n\n
<?php\n\nnamespace WkDailyQuote\\DTO;\n\nclass Quote\n{\n    public function __construct(\n        private int    $id,\n        private string $quote,\n        private string $author\n    ) {\n        if (empty($quote)) {\n            throw new \\InvalidArgumentException('Quote cannot be empty');\n        }\n        if (empty($author)) {\n            throw new \\InvalidArgumentException('Author cannot be empty');\n        }\n    }\n    public static function fromArray(array $data): self\n    {\n        if (!isset($data['id'], $data['quote'], $data['author'])) {\n            throw new \\InvalidArgumentException('Invalid API response structure');\n        }\n        return new self((int)$data['id'], $data['quote'], $data['author']);\n    }\n    public function getId(): int\n    {\n        return $this->id;\n    }\n    public function getQuote(): string\n    {\n        return $this->quote;\n    }\n    public function getAuthor(): string\n    {\n        return $this->author;\n    }\n    public function toArray(): array\n    {\n        return ['id' => $this->id, 'quote' => $this->quote, 'author' => $this->author];\n    }\n}<\/pre>\n\n\n\n
Step 3: Create Custom Exception Classes<\/h4>\n\n\n\n
Instead of catching a generic \\Exception<\/code> everywhere, create your own API-specific exception class (or small exception hierarchy). <\/p>\n\n\n\n
Using named factory methods (like ApiException::networkError()<\/code> or ApiException::invalidResponse()<\/code>) also makes your throw<\/code> statements clearer and easier to understand.<\/p>\n\n\n\n
File:<\/strong> \/modules\/wkdailyquote\/src\/Exception\/ApiException.php<\/code><\/p>\n\n\n\n
<?php\n\nnamespace WkDailyQuote\\Exception;\n\nclass ApiException extends \\Exception\n{\n    public static function networkError(string $message, ?\\Throwable $prev = null): self\n    {\n        return new self("Network error: $message", 0, $prev);\n    }\n\n    public static function httpError(int $statusCode, string $url): self\n    {\n        return new self("HTTP $statusCode error when accessing $url");\n    }\n\n    public static function invalidResponse(string $message): self\n    {\n        return new self("Invalid API response: $message");\n    }\n}<\/pre>\n\n\n\n
Step 4: Build the Cache Manager Service<\/h4>\n\n\n\n
Calling an external API on every page load is slow and wastes rate limit quota. The QuoteCacheManager wraps PrestaShop’s built-in cache system with a clean interface.<\/p>\n\n\n\n
File:<\/strong> \/modules\/wkdailyquote\/src\/Service\/QuoteCacheManager.php<\/code><\/p>\n\n\n\n
<?php\n\nnamespace WkDailyQuote\\Service;\n\nuse WkDailyQuote\\DTO\\Quote;\n\nclass QuoteCacheManager\n{\n    private const CACHE_KEY = 'wkdailyquote_current';\n    private const CACHE_TTL = 3600;\n\n    public function get(): ?Quote\n    {\n        $cached = \\Cache::getInstance()->get(self::CACHE_KEY);\n\n        return $cached ? Quote::fromArray($cached) : null;\n    }\n\n    public function set(Quote $quote): void\n    {\n        \\Cache::getInstance()->set(self::CACHE_KEY, $quote->toArray(), self::CACHE_TTL);\n    }\n\n    public function clear(): void\n    {\n        \\Cache::getInstance()->delete(self::CACHE_KEY);\n    }\n}<\/pre>\n\n\n\n
Step 5: Build the API Service (The Heart of the Module)<\/h4>\n\n\n\n
Here\u00a0Symfony HTTP Client<\/strong>\u00a0is actually used. The\u00a0QuoteFetcher\u00a0service receives the client via\u00a0constructor injection<\/strong>, it never instantiates it directly. This is the key difference from the old approach.<\/p>\n\n\n\n
Notice how Symfony’s $response->toArray() handles JSON parsing automatically, and how each error type maps cleanly to a specific exception class via Symfony’s exception hierarchy.<\/p>\n\n\n\n
File:<\/strong> \/modules\/wkdailyquote\/src\/Service\/QuoteFetcher.php<\/code><\/p>\n\n\n\n
<?php\n\nnamespace WkDailyQuote\\Service;\n\nuse WkDailyQuote\\DTO\\Quote;\nuse WkDailyQuote\\Exception\\ApiException;\nuse WkDailyQuote\\Service\\QuoteCacheManager;\nuse Symfony\\Contracts\\HttpClient\\HttpClientInterface;\nuse Symfony\\Contracts\\HttpClient\\Exception\\TransportExceptionInterface;\n\nclass QuoteFetcher\n{\n    private const API_URL = 'https:\/\/dummyjson.com\/quotes\/random';\n    private const TIMEOUT = 5;\n    private const MAX_RETRIES = 2;\n\n    public function __construct(\n        private readonly HttpClientInterface $httpClient,\n        private readonly QuoteCacheManager   $cacheManager\n    ) {\n    }\n\n    public function getRandomQuote(): ?Quote\n    {\n        if ($cached = $this->cacheManager->get()) {\n            return $cached;\n        }\n\n        try {\n            $quote = $this->fetchWithRetry();\n            $this->cacheManager->set($quote);\n            return $quote;\n        } catch (ApiException $e) {\n            \\PrestaShopLogger::addLog("[WkDailyQuote] {$e->getMessage()}", 3);\n            return null;\n        }\n    }\n\n    private function fetchWithRetry(): Quote\n    {\n        for ($attempt = 1; $attempt <= self::MAX_RETRIES; $attempt++) {\n            try {\n                return $this->makeRequest();\n            } catch (ApiException $e) {\n                if ($attempt < self::MAX_RETRIES) {\n                    usleep(pow(2, $attempt) * 100000);\n                }\n                $last = $e;\n            }\n        }\n        throw $last;\n    }\n\n    private function makeRequest(): Quote\n    {\n        try {\n            $response = $this->httpClient->request('GET', self::API_URL, [\n                'timeout' => self::TIMEOUT,\n                'headers' => ['Accept' => 'application\/json'],\n            ]);\n\n            if ($response->getStatusCode() !== 200) {\n                throw ApiException::httpError($response->getStatusCode(), self::API_URL);\n            }\n\n            return Quote::fromArray($response->toArray());\n        } catch (TransportExceptionInterface $e) {\n            throw ApiException::networkError($e->getMessage(), $e);\n        } catch (\\InvalidArgumentException $e) {\n            throw ApiException::invalidResponse($e->getMessage());\n        }\n    }\n}<\/pre>\n\n\n\n
Step 6: Configure Dependency Injection<\/h4>\n\n\n\n
This YAML file is where the magic happens. It tells Symfony’s container\u00a0how to wire everything together<\/em>. <\/p>\n\n\n\n
The container sees that\u00a0QuoteFetcher\u00a0needs an\u00a0HttpClientInterface, so it automatically injects the built-in\u00a0@http_client\u00a0service \u2014 you never instantiate it yourself.<\/p>\n\n\n\n
File:<\/strong> \/modules\/wkdailyquote\/config\/services.yml<\/code><\/p>\n\n\n\n
services:\n  _defaults:\n    autowire: true\n    autoconfigure: true\n    public: false\n\n  WkDailyQuote\\:\n    resource: '..\/src\/*'\n    exclude:  '..\/src\/{index.php,DTO}'\n\n  WkDailyQuote\\Service\\QuoteCacheManager:\n    public: true\n\n  WkDailyQuote\\Service\\QuoteFetcher:\n    public: true\n    arguments:\n      $httpClient:   '@http_client'\n      $cacheManager: '@WkDailyQuote\\Service\\QuoteCacheManager'<\/pre>\n\n\n\n
Step 7: Create the Main Module File<\/h4>\n\n\n\n
The main\u00a0wkdailyquote.php<\/strong>\u00a0file registers hooks, resolves services from the container, and delegates all real work to them. <\/p>\n\n\n\n
Notice there is no HTTP code here whatsoever, that separation of concerns is exactly the goal.<\/p>\n\n\n\n
File:<\/strong> \/modules\/wkdailyquote\/wkdailyquote<\/code>.php<\/code><\/p>\n\n\n\n
<?php\n\nrequire_once __DIR__ . '\/vendor\/autoload.php';\n\nuse PrestaShop\\PrestaShop\\Adapter\\SymfonyContainer;\nuse WkDailyQuote\\Service\\QuoteFetcher;\nuse WkDailyQuote\\Service\\QuoteCacheManager;\n\nclass WkDailyQuote extends Module\n{\n    public function __construct()\n    {\n        $this->name = 'wkdailyquote';\n        $this->tab = 'administration';\n        $this->version = '1.0.0';\n        $this->author = 'wk';\n        $this->need_instance = 0;\n        $this->ps_versions_compliancy = [\n            'min' => '9.0.0',\n            'max' => _PS_VERSION_\n        ];\n        $this->bootstrap = true;\n\n        parent::__construct();\n\n        $this->displayName = $this->l('Daily Quote');\n        $this->description = $this->l('Displays inspirational quotes on your dashboard using Symfony HTTP Client with caching.');\n        $this->confirmUninstall = $this->l('Are you sure you want to uninstall this module?');\n    }\n\n    public function install(): bool\n    {\n        return parent::install()  && $this->registerHook('displayDashboardTop');\n    }\n\n    public function uninstall(): bool\n    {\n        $this->clearModuleCache();\n\n        return parent::uninstall();\n    }\n\n    public function hookDisplayDashboardTop(array $params)\n    {\n        if ($this->context->controller->controller_name != 'AdminDashboard') return;\n\n        $container = SymfonyContainer::getInstance();\n\n        if (!$container->has(QuoteFetcher::class)) {\n            return '';\n        }\n\n        $quote = $container->get(QuoteFetcher::class)->getRandomQuote();\n\n        if (!$quote) {\n            return $this->renderErrorMessage();\n        }\n\n        $this->context->smarty->assign([\n            'quote_text'   => $quote->getQuote(),\n            'quote_author' => $quote->getAuthor(),\n            'quote_id'     => $quote->getId(),\n        ]);\n\n        return $this->display(__FILE__, 'views\/templates\/hook\/dashboard_quote.tpl');\n    }\n\n    private function clearModuleCache(): void\n    {\n        $container = SymfonyContainer::getInstance();\n\n        if ($container->has(QuoteCacheManager::class)) {\n            \/** @var QuoteCacheManager $cacheManager *\/\n            $cacheManager = $container->get(QuoteCacheManager::class);\n            $cacheManager->clear();\n        }\n    }\n}<\/pre>\n\n\n\n
Step 8: Create the View Templates<\/h4>\n\n\n\n
File:<\/strong> \/modules\/wkdailyquote\/views\/templates\/hook\/dashboard_quote.tpl<\/code><\/p>\n\n\n\n
<section id="wkdailyquote" class="panel widget wkdailyquote-container">\n  <div class="panel-heading">\n    <i class="icon-quote-left"><\/i>\n    {l s='Quote of the Moment' mod='wkdailyquote'}\n  <\/div>\n  <div class="panel-body">\n    <blockquote class="wkdailyquote-quote">\n      <p>{$quote_text|escape:'html':'UTF-8'}<\/p>\n      <footer><cite>{$quote_author|escape:'html':'UTF-8'}<\/cite><\/footer>\n    <\/blockquote>\n  <\/div>\n<\/section><\/pre>\n\n\n\n
In this example, we are displaying a quote on dashboard using the PrestaShop hook. <\/p>\n\n\n\n
While simple, this module will shows the exact architecture required for complex integrations like ERPs, shipping carriers, or payment gateways.<\/p>\n\n\n\n
Here is the result below:<\/strong><\/p>\n\n\n\n
\"wkdailyquote\"<\/figure>\n\n\n\n
The architecture you’ve built is designed to scale. Here are four powerful ways to extend its capabilities once the foundation is in place:<\/p>\n\n\n\n