Unplug the HTTPlug

HTTPlug ?

Un éléphant qui parle HTTP !

Rentrons dans le vif du sujet, HTTPlug est un ensemble de librairie qui permet de gérer les appels HTTP dans vos applications.
▶ Très impliqués dans les PSR, les mainteneurs essaient de structurer cette partie de plus en plus centrale dans les projets.
J'ai découvert ces outils il y a quelques années et j'avais même contribué au développement de l'adapteur ReactPHP. Je reviendrai dessus un peu plus tard.
Aujourd'hui, je ne démarre pas un projet sans utiliser HTTPlug et c'est même un critère de choix dans les dépendances que je vais installer.

Un écosystème complet

Clients: cURL, socket.

Adapteurs: Guzzle(5/6), Symfony HTTPClient, ReactPHP…

Plugins: Authentification, Log, Cache…

                            composer require php-http/[client,plugin]

L'éventail de solution proposée est large et permet donc de s'adapter aux habitudes de chaque équipe. C'est pour moi une des forces parce que si vous êtes habitué à utilisé cURL, vous pouvez continuer de le faire, pareil si vous préférez Guzzle ou autre.
Finalement c'est un ensemble d'interfaces et d'implémentations qui sont interchengeables en fonction des besoins.
Malgré tout, chaque implémentation est spécifique. Par exemple, le client HTTP de Symfony gérait le HTTP2 à sa sortie ce qui n'était pas le cas de tout les autres.
▶ Si vous avez des besoins précis, il suffit juste de remplacer l'implémentation avec le bon paquet composer et voila.
Le code de l'application ne changera pas et vos tests continueront de fonctionner !

Unplug the HTTPlug 2020 - AFUP Day Lyon Bonjour à tous !

	use Psr\Http\Client\ClientInterface;
	use Psr\Http\Message\RequestInterface;

	class MyApiDataRetriever
	{
	private $httpClient;

	public function __construct(ClientInterface $httpClient)
	{
	$this->httpClient = $httpClient;
	}

	public function retrieveData(RequestInterface $message): AwesomeDTO
	{
	return AwesomeDTO::fromResponse(
	$this->httpClient->sendRequest($message)
	);
	}
	}

	use Psr\Http\Client\ClientInterface;
	use Psr\Http\Message\RequestInterface;

	class MyApiDataRetriever
	{
	private $httpClient;

	public function __construct(ClientInterface $httpClient)
	{
	$this->httpClient = $httpClient;
	}

	public function retrieveData(RequestInterface $message): AwesomeDTO
	{
	return AwesomeDTO::fromResponse(
	$this->httpClient->sendRequest($message)
	);
	}
	}

	use Psr\Http\Client\ClientInterface;
	use Psr\Http\Message\RequestInterface;

	class MyApiDataRetriever
	{
	private $httpClient;

	public function __construct(ClientInterface $httpClient)
	{
	$this->httpClient = $httpClient;
	}

	public function retrieveData(RequestInterface $message): AwesomeDTO
	{
	return AwesomeDTO::fromResponse(
	$this->httpClient->sendRequest($message)
	);
	}
	}

	use Http\Adapter\React\Client;
	use Laminas\Diactoros\RequestFactory;

	$client = new Client(/* options */);

	$dto = (new MyApiDataRetriever($client))->retrieveData(
	(new RequestFactory)->createRequest('GET', 'http://example.com/api')
	);

	use Http\Adapter\React\Client;
	use Laminas\Diactoros\RequestFactory;

	$client = new Client(/* options */);

	$dto = (new MyApiDataRetriever($client))->retrieveData(
	(new RequestFactory)->createRequest('GET', 'http://example.com/api')
	);

Unplug the HTTPlug

Stéphane Hulard

HTTPlug ?

Pourquoi ?

🐣 L'arrivée d'HTTPlug

Un écosystème complet

Encore un nouvel outil ?

Prendre du recul

Utilisation des PSRs

Implémentation

Automatisation

Une complexité faible

Adaptabilité et décorateurs

Tester les appels HTTP 😱…

Les interfaces à la rescousse

Vous avez le pouvoir

	use Http\Discovery\HttpClientDiscovery;
	use Http\Discovery\MessageFactoryDiscovery;

	$client = HttpClientDiscovery::find();
	$messageFactory = MessageFactoryDiscovery::find();

	$dto = (new MyApiDataRetriever($client))->retrieveData(
	$messageFactory->createRequest('GET', 'http://example.com/api')
	);

	class AwesomeDecorator implements ClientInterface
	{
	private $decorated;
	public function __construct(ClientInterface $client)
	{
	$this->decorated = $client;
	}

	public function sendRequest(RequestInterface $request): ResponseInterface
	{
	/* Vérification ou traitement spécifique */
	$response = $this->decorated->sendRequest($request);
	/* Vérification ou traitement spécifique */
	return $response;
	}
	}

	$client = new Http\Mock\Client;

	$client->on(
	new RequestMatcher('/api', 'example.com'),
	function (): ResponseInterface {
	/* Créer une réponse adaptée */
	return $response;
	}
	);

	$dto = (new MyApiDataRetriever($client))->retrieveData(
	$messageFactory->createRequest('GET', 'http://example.com/api')
	);