Parler Ă dâautres API : Guzzle
Presque toute fonctionnalitĂ© qui « parle Ă un autre service » revient Ă envoyer des requĂȘtes HTTP et Ă traiter les rĂ©ponses. Guzzle est la façon par dĂ©faut de le faire en PHP depuis plus de dix ans, et il se comporte de la mĂȘme maniĂšre dans un framework et dans un script de quarante lignes.
composer require guzzlehttp/guzzle
<?php
require 'vendor/autoload.php';
use GuzzleHttp\Client;
$client = new Client(['base_uri' => 'https://api.example.com']);
$response = $client->get('/users/42', [
'headers' => ['Authorization' => 'Bearer ' . getenv('API_TOKEN')],
]);
$user = json_decode($response->getBody()->getContents(), true);
echo $user['name'];
Guzzle prend aussi en charge ce qui devient fastidieux Ă Ă©crire soi-mĂȘme : les nouvelles tentatives, les dĂ©lais dâexpiration, le streaming des grosses rĂ©ponses, et les requĂȘtes concurrentes qui ne sâattendent pas les unes les autres.
use GuzzleHttp\Promise\Utils;
$promises = [
'users' => $client->getAsync('/users'),
'orders' => $client->getAsync('/orders'),
];
$results = Utils::unwrap($promises);
Quand le choisir
Tout script ou service qui appelle une API tierce sans ĂȘtre dĂ©jĂ dans un framework dotĂ© de son propre client HTTP. La façade Http de Laravel et le composant HttpClient de Symfony emballent les mĂȘmes idĂ©es, et lâun comme lâautre est un bon choix si vous y ĂȘtes dĂ©jĂ . Guzzle est la valeur sĂ»re quand vous ne savez pas encore Ă quoi ressemblera le reste du projet.
Quand ce nâest pas le bon outil
Au fond dâun projet Laravel, Http::get(...) est Guzzle sous une syntaxe plus aimable. Il y a rarement une raison de le contourner pour appeler Guzzle directement.
Sous le capot : Guzzle et la plupart des clients HTTP en PHP parlent PSR-7 et PSR-18, des interfaces standard pour les messages et les clients HTTP. Câest pour cela que la façade
Httpde Laravel, leHttpClientde Symfony et Guzzle peuvent se passer des requĂȘtes et des rĂ©ponses sans quâaucun ne sache que les autres existent.