70 lines
2.5 KiB
Markdown
70 lines
2.5 KiB
Markdown
## Controlling HTTP abstraction layer
|
|
|
|
You can replace default PSR dependencies in the client while using `ClientFactory` or `ClientBuilder`. It can be useful for tests
|
|
or if you want to use a specific implementation that is not supported by the service discovery.
|
|
|
|
Both `ClientFactory` and `ClientBuilder` provide those methods:
|
|
|
|
```php
|
|
/**
|
|
* Set your PSR-18 HTTP client.
|
|
*
|
|
* Service discovery will be used if no client has been provided.
|
|
*
|
|
* @param \Psr\Http\Client\ClientInterface $httpClient
|
|
*/
|
|
public function setHttpClient(\Psr\Http\Client\ClientInterface $httpClient);
|
|
|
|
/**
|
|
* Sets PSR-17 compatible stream factory. You can skip this step if you want to use service discovery.
|
|
*
|
|
* @param \Psr\Http\Message\StreamFactoryInterface|null $streamFactory
|
|
*/
|
|
public function setStreamFactory(?\Psr\Http\Message\StreamFactoryInterface $streamFactory);
|
|
|
|
/**
|
|
* Sets PSR-17 compatible request factory. You can skip this step if you want to use service discovery.
|
|
*
|
|
* @param \Psr\Http\Message\RequestFactoryInterface|null $requestFactory
|
|
*/
|
|
public function setRequestFactory(?\Psr\Http\Message\RequestFactoryInterface $requestFactory);
|
|
|
|
/**
|
|
* Sets PSR-17 compatible URI factory. You can skip this step if you want to use service discovery.
|
|
*
|
|
* @param \Psr\Http\Message\UriFactoryInterface|null $uriFactory
|
|
*/
|
|
public function setUriFactory(?\Psr\Http\Message\UriFactoryInterface $uriFactory);
|
|
```
|
|
|
|
They can be used to specify PSR dependencies like this:
|
|
|
|
```php
|
|
$psr17Factory = new \Nyholm\Psr7\Factory\Psr17Factory();
|
|
$factory = new \RetailCrm\Api\Factory\ClientFactory();
|
|
$factory->setHttpClient(new \Http\Client\Curl\Client())
|
|
->setRequestFactory($psr17Factory)
|
|
->setStreamFactory($psr17Factory)
|
|
->setUriFactory($psr17Factory);
|
|
|
|
$client = $factory->createClient('https://test.retailcrm.pro', 'apiKey');
|
|
```
|
|
|
|
Or like this:
|
|
|
|
```php
|
|
$psr17Factory = new \Nyholm\Psr7\Factory\Psr17Factory();
|
|
$builder = new \RetailCrm\Api\Builder\ClientBuilder();
|
|
$client = $builder
|
|
->setApiUrl('https://test.retailcrm.pro')
|
|
->setAuthenticatorHandler(new \RetailCrm\Api\Handler\Request\HeaderAuthenticatorHandler('apiKey'))
|
|
->setHttpClient(new \Http\Client\Curl\Client())
|
|
->setRequestFactory($psr17Factory)
|
|
->setStreamFactory($psr17Factory)
|
|
->setUriFactory($psr17Factory)
|
|
->build();
|
|
```
|
|
|
|
By replacing the HTTP client in the test environment you can easily mock requests and responses via libraries like
|
|
[`neur0toxine/pock`](https://packagist.org/packages/neur0toxine/pock) or [`php-http/mock-client`](https://packagist.org/packages/php-http/mock-client).
|