Class Sabre\HTTP\Client

`extends`	`EventEmitter`

A rudimentary HTTP client.

This object wraps PHP's curl extension and provides an easy way to send it a Request object, and return a Response object.

This is by no means intended as the next best HTTP client, but it does the job and provides a simple integration with the rest of sabre/http.

This client emits the following events: beforeRequest(RequestInterface $request) afterRequest(RequestInterface $request, ResponseInterface $response) error(RequestInterface $request, ResponseInterface $response, bool &$retry, int $retryCount) exception(RequestInterface $request, ClientException $e, bool &$retry, int $retryCount)

The beforeRequest event allows you to do some last minute changes to the request before it's done, such as adding authentication headers.

The afterRequest event will be emitted after the request is completed successfully.

If a HTTP error is returned (status code higher than 399) the error event is triggered. It's possible using this event to retry the request, by setting retry to true.

The amount of times a request has retried is passed as $retryCount, which can be used to avoid retrying indefinitely. The first time the event is called, this will be 0.

It's also possible to intercept specific http errors, by subscribing to for example 'error:401'.

Sabre\Event\EventEmitter implements EmitterInterface uses EmitterTrait
- Sabre\HTTP\Client
  - Sabre\DAV\Client
    - Afterlogic\DAV\Client

Methods
`public`	`__construct()` Initializes the client. Initializes the client. Overriden by `Sabre\DAV\Client::__construct()`	#
`public`	`send(RequestInterface $request): ResponseInterface` Sends a request to a HTTP server, and returns a response. Sends a request to a HTTP server, and returns a response.	#
`public`	`sendAsync(RequestInterface $request, callable $success = null, callable $error = null)` Sends a HTTP request asynchronously. Sends a HTTP request asynchronously. Due to the nature of PHP, you must from time to time poll to see if any new responses came in. After calling sendAsync, you must therefore occasionally call the poll() method, or wait().	#
`public`	`poll(): bool` This method checks if any http requests have gotten results, and if so, call the appropriate success or error handlers. This method checks if any http requests have gotten results, and if so, call the appropriate success or error handlers. This method will return true if there are still requests waiting to return, and false if all the work is done.	#
`public`	`wait()` Processes every HTTP request in the queue, and waits till they are all completed. Processes every HTTP request in the queue, and waits till they are all completed.	#
`public`	`setThrowExceptions(bool $throwExceptions)` If this is set to true, the Client will automatically throw exceptions upon HTTP errors. If this is set to true, the Client will automatically throw exceptions upon HTTP errors. This means that if a response came back with a status code greater than or equal to 400, we will throw a ClientHttpException. This only works for the send() method. Throwing exceptions for sendAsync() is not supported.	#
`public`	`addCurlSetting(int $name, mixed $value)` Adds a CURL setting. Adds a CURL setting. These settings will be included in every HTTP request.	#

Methods used from Sabre\Event\EmitterTrait
`on(), once(), emit(), listeners(), removeListener(), removeAllListeners()`

Constants
`public`	`STATUS_SUCCESS = 0`	#
`public`	`STATUS_CURLERROR = 1`	#
`public`	`STATUS_HTTPERROR = 2`	#

Namespaces

Classes

Interfaces

Class Sabre\HTTP\Client

Overriden by