php-http/discovery

Finds installed HTTPlug implementations and PSR-7 message factories

HTTPlug Discovery

, _(*1)

This library provides auto-discovery and auto-installation of well-known PSR-17, PSR-18 and HTTPlug implementations., _(*2)

Install

Via Composer, _(*3)

``` bash composer require php-http/discovery, <sub>(*4)</sub>

## Usage as a library author

Please see the [official documentation](http://php-http.readthedocs.org/en/latest/discovery.html).

If your library/SDK needs a PSR-18 client, here is a quick example.

First, you need to install a PSR-18 client and a PSR-17 factory implementations.
This should be done only for dev dependencies as you don't want to force a
specific implementation on your users:

```bash
composer require --dev symfony/http-client
composer require --dev nyholm/psr7

Then, you can disable the Composer plugin embeded in php-http/discovery because you just installed the dev dependencies you need for testing:, <sub>(*5)</sub>

composer config allow-plugins.php-http/discovery false

Finally, you need to require php-http/discovery and the generic implementations that your library is going to need:, <sub>(*6)</sub>

composer require 'php-http/discovery:^1.17'
composer require 'psr/http-client-implementation:*'
composer require 'psr/http-factory-implementation:*'

Now, you're ready to make an HTTP request:, <sub>(*7)</sub>

use Http\Discovery\Psr18Client;

$client = new Psr18Client();

$request = $client->createRequest('GET', 'https://example.com');
$response = $client->sendRequest($request);

Internally, this code will use whatever PSR-7, PSR-17 and PSR-18 implementations that your users have installed., <sub>(*8)</sub>

Usage as a library user

If you use a library/SDK that requires php-http/discovery, you can configure the auto-discovery mechanism to use a specific implementation when many are available in your project., <sub>(*9)</sub>

For example, if you have both nyholm/psr7 and guzzlehttp/guzzle in your project, you can tell php-http/discovery to use guzzlehttp/guzzle instead of nyholm/psr7 by running the following command:, <sub>(*10)</sub>

composer config extra.discovery.psr/http-factory-implementation GuzzleHttp\\Psr7\\HttpFactory

This will update your composer.json file to add the following configuration:, <sub>(*11)</sub>

{
    "extra": {
        "discovery": {
            "psr/http-factory-implementation": "GuzzleHttp\\Psr7\\HttpFactory"
        }
    }
}

Don't forget to run composer install to apply the changes, and ensure that the composer plugin is enabled:, <sub>(*12)</sub>

composer config allow-plugins.php-http/discovery true
composer install

Testing

bash composer test, <sub>(*13)</sub>

Contributing

Please see our contributing guide., <sub>(*14)</sub>

Security

If you discover any security related issues, please contact us at security@php-http.org., <sub>(*15)</sub>

License

The MIT License (MIT). Please see License File for more information., <sub>(*16)</sub>