Guzzle 7 Adapter¶
An HTTPlug adapter for the Guzzle 7 HTTP client. Guzzle 7 supports PSR-18
out of the box. This adapter makes sense if you want to use HTTPlug async interface or to use
Guzzle 7 with a library that did not upgrade to PSR-18 yet and depends on
To install the Guzzle adapter, which will also install Guzzle itself (if it was not yet included in your project), run:
$ composer require php-http/guzzle7-adapter
To create a Guzzle7 adapter you should use the createWithConfig() function. It will let you to pass Guzzle configuration to the client:
use Http\Adapter\Guzzle7\Client as GuzzleAdapter; $config = [ 'timeout' => 2, 'handler' => //... // ... ]; $adapter = GuzzleAdapter::createWithConfig($config);
If you want even more control over your Guzzle object, you may give a Guzzle client as first argument to the adapter’s constructor:
use GuzzleHttp\Client as GuzzleClient; use Http\Adapter\Guzzle7\Client as GuzzleAdapter; $config = ['timeout' => 5]; // ... $guzzle = new GuzzleClient($config); // ... $adapter = new GuzzleAdapter($guzzle);
If you pass a Guzzle instance to the adapter, make sure to configure Guzzle to not throw exceptions on HTTP error status codes, or this adapter will violate PSR-18.
And use it to send synchronous requests:
use GuzzleHttp\Psr7\Request; $request = new Request('GET', 'http://httpbin.org'); // Returns a Psr\Http\Message\ResponseInterface $response = $adapter->sendRequest($request);
Or send asynchronous ones:
use GuzzleHttp\Psr7\Request; $request = new Request('GET', 'http://httpbin.org'); // Returns a Http\Promise\Promise $promise = $adapter->sendAsyncRequest(request);
- Use plugins to customize the way HTTP requests are sent and responses processed by following redirects, adding Authentication or Cookie headers and more.
- Learn how you can decouple your code from any PSR-7 implementation by using the HTTP factories.
- Read more about promises when using asynchronous requests.