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 ``php-http/client-implementation``.

Installation
------------

To install the Guzzle adapter, which will also install Guzzle itself (if it was
not yet included in your project), run:

.. code-block:: bash

    $ composer require php-http/guzzle7-adapter

Usage
-----

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);

.. note::

    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);


.. include:: includes/further-reading-async.inc

.. _Guzzle 7 HTTP client: http://docs.guzzlephp.org/en/7.0/