.. rst-class:: phpdoctorst .. role:: php(code) :language: php BaseHttpClient ============== .. php:namespace:: Firstred\PostNL\HttpClient .. rst-class:: abstract .. php:class:: BaseHttpClient Summary ------- Methods ~~~~~~~ * :php:meth:`public getTimeout\(\)` * :php:meth:`public setTimeout\($seconds\)` * :php:meth:`public getConnectTimeout\(\)` * :php:meth:`public setConnectTimeout\($seconds\)` * :php:meth:`public getVerify\(\)` * :php:meth:`public setVerify\($verify\)` * :php:meth:`public getLogger\(\)` * :php:meth:`public setLogger\($logger\)` * :php:meth:`public getMaxRetries\(\)` * :php:meth:`public setMaxRetries\($maxRetries\)` * :php:meth:`public setConcurrency\($concurrency\)` * :php:meth:`public getConcurrency\(\)` * :php:meth:`public addOrUpdateRequest\($id, $request\)` * :php:meth:`public removeRequest\($id\)` * :php:meth:`public clearRequests\(\)` * :php:meth:`public doRequests\($requests\)` * :php:meth:`public getRequestFactory\(\)` * :php:meth:`public setRequestFactory\($requestFactory\)` * :php:meth:`public getResponseFactory\(\)` * :php:meth:`public setResponseFactory\($responseFactory\)` * :php:meth:`public getStreamFactory\(\)` * :php:meth:`public setStreamFactory\($streamFactory\)` Constants --------- .. php:const:: DEFAULT_TIMEOUT = 80 .. php:const:: DEFAULT_CONNECT_TIMEOUT = 30 Properties ---------- .. php:attr:: protected static timeout :Type: int .. php:attr:: protected static connectTimeout :Type: int .. php:attr:: protected static verify .. rst-class:: phpdoc-description | Verify the server SSL certificate\. :Type: bool | string .. php:attr:: protected static pendingRequests :Type: array .. php:attr:: protected static logger :Type: :any:`\\Psr\\Log\\LoggerInterface ` .. php:attr:: protected static maxRetries :Type: int .. php:attr:: protected static concurrency :Type: int .. php:attr:: protected static requestFactory :Type: :any:`\\Psr\\Http\\Message\\RequestFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\RequestFactoryInterface ` .. php:attr:: protected static responseFactory :Type: :any:`\\Psr\\Http\\Message\\ResponseFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\ResponseFactoryInterface ` .. php:attr:: protected static streamFactory :Type: :any:`\\Psr\\Http\\Message\\StreamFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\StreamFactoryInterface ` Methods ------- .. rst-class:: public .. php:method:: public getTimeout() .. rst-class:: phpdoc-description | Get timeout\. :Returns: int .. rst-class:: public .. php:method:: public setTimeout( $seconds) .. rst-class:: phpdoc-description | Set timeout\. :Parameters: * **$seconds** (int) :Returns: static .. rst-class:: public .. php:method:: public getConnectTimeout() .. rst-class:: phpdoc-description | Get connection timeout\. :Returns: int .. rst-class:: public .. php:method:: public setConnectTimeout( $seconds) .. rst-class:: phpdoc-description | Set connection timeout\. :Parameters: * **$seconds** (int) :Returns: static .. rst-class:: public deprecated .. php:method:: public getVerify() .. rst-class:: phpdoc-description | Return verify setting\. :Returns: bool | string :Deprecated: .. rst-class:: public deprecated .. php:method:: public setVerify( $verify) .. rst-class:: phpdoc-description | Set the verify setting\. :Parameters: * **$verify** (bool | string) :Returns: static :Deprecated: .. rst-class:: public .. php:method:: public getLogger() .. rst-class:: phpdoc-description | Get logger\. :Returns: :any:`\\Psr\\Log\\LoggerInterface ` .. rst-class:: public .. php:method:: public setLogger( $logger) .. rst-class:: phpdoc-description | Set the logger\. :Parameters: * **$logger** (:any:`Psr\\Log\\LoggerInterface `) :Returns: static .. rst-class:: public .. php:method:: public getMaxRetries() .. rst-class:: phpdoc-description | Return max retries\. :Returns: int .. rst-class:: public .. php:method:: public setMaxRetries( $maxRetries) .. rst-class:: phpdoc-description | Set the amount of retries\. :Parameters: * **$maxRetries** (int) :Returns: static .. rst-class:: public .. php:method:: public setConcurrency( $concurrency) .. rst-class:: phpdoc-description | Set the concurrency\. :Parameters: * **$concurrency** (int) :Returns: static .. rst-class:: public .. php:method:: public getConcurrency() .. rst-class:: phpdoc-description | Return concurrency\. :Returns: int .. rst-class:: public .. php:method:: public addOrUpdateRequest( $id, $request) .. rst-class:: phpdoc-description | Adds a request to the list of pending requests | Using the ID you can replace a request\. :Parameters: * **$id** (string) Request ID * **$request** (:any:`Psr\\Http\\Message\\RequestInterface `) PSR-7 request :Returns: int | string :Throws: :any:`\\Firstred\\PostNL\\Exception\\InvalidArgumentException ` .. rst-class:: public .. php:method:: public removeRequest( $id) .. rst-class:: phpdoc-description | Remove a request from the list of pending requests\. :Parameters: * **$id** (string) .. rst-class:: public .. php:method:: public clearRequests() .. rst-class:: phpdoc-description | Clear all pending requests\. .. rst-class:: public .. php:method:: public doRequests( $requests=\[\]) .. rst-class:: phpdoc-description | Do all async requests\. | Exceptions are captured into the result array :Parameters: * **$requests** (:any:`Psr\\Http\\Message\\RequestInterface\[\] `) :Returns: :any:`\\Firstred\\PostNL\\Exception\\HttpClientException\[\] ` | :any:`\\Psr\\Http\\Message\\ResponseInterface\[\] ` :Throws: :any:`\\Firstred\\PostNL\\Exception\\InvalidArgumentException ` .. rst-class:: public .. php:method:: public getRequestFactory() .. rst-class:: phpdoc-description | Get PSR\-7 Request factory\. :Returns: :any:`\\Psr\\Http\\Message\\RequestFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\RequestFactoryInterface ` :Throws: :any:`\\Firstred\\PostNL\\Exception\\NotSupportedException ` :Since: 1.3.0 .. rst-class:: public .. php:method:: public setRequestFactory( $requestFactory) .. rst-class:: phpdoc-description | Set PSR\-7 Request factory\. :Parameters: * **$requestFactory** (:any:`Psr\\Http\\Message\\RequestFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\RequestFactoryInterface `) :Returns: static :Since: 1.3.0 .. rst-class:: public .. php:method:: public getResponseFactory() .. rst-class:: phpdoc-description | Get PSR\-7 Response factory\. :Returns: :any:`\\Psr\\Http\\Message\\ResponseFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\ResponseFactoryInterface ` :Throws: :any:`\\Firstred\\PostNL\\Exception\\NotSupportedException ` :Since: 1.3.0 .. rst-class:: public .. php:method:: public setResponseFactory( $responseFactory) .. rst-class:: phpdoc-description | Set PSR\-7 Response factory\. :Parameters: * **$responseFactory** (:any:`Psr\\Http\\Message\\ResponseFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\ResponseFactoryInterface `) :Returns: static :Since: 1.3.0 .. rst-class:: public .. php:method:: public getStreamFactory() .. rst-class:: phpdoc-description | Set PSR\-7 Stream factory\. :Returns: :any:`\\Psr\\Http\\Message\\StreamFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\StreamFactoryInterface ` :Throws: :any:`\\Firstred\\PostNL\\Exception\\NotSupportedException ` :Since: 1.3.0 .. rst-class:: public .. php:method:: public setStreamFactory( $streamFactory) .. rst-class:: phpdoc-description | Set PSR\-7 Stream factory\. :Parameters: * **$streamFactory** (:any:`Psr\\Http\\Message\\StreamFactoryInterface ` | :any:`\\Firstred\\PostNL\\Factory\\StreamFactoryInterface `) :Returns: static :Since: 1.3.0