Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

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 Http de Laravel, le HttpClient de Symfony et Guzzle peuvent se passer des requĂȘtes et des rĂ©ponses sans qu’aucun ne sache que les autres existent.