`Fetch\Http\ClientHandler`

ClientHandler implements Fetch\Interfaces\ClientHandler, combining configuration, execution, promise, retry, cache, debugging, middleware, event, pool, and Guzzle-client contracts.

Create a handler with create(), createWithBaseUri(), or createWithClient().

Request execution

The fluent request methods return a Fetch response or a React promise when async mode is enabled.

The following PHP blocks are selected interface excerpts. Method and ContentType refer to Fetch\Enum; PromiseInterface is ReactPHP's promise contract, and Response is Fetch\Interfaces\Response.

`request()`

php

interface RequestExecutor
{
    public function request(
        string|Method $method,
        string $uri,
        mixed $body = null,
        string|ContentType $contentType = ContentType::JSON,
        array $options = [],
    ): Response|PromiseInterface;
}

`sendRequest()` and `get()`

php

interface RequestExecutor
{
    public function sendRequest(
        Method|string $method,
        string $uri,
        array $options = [],
    ): Response|PromiseInterface;

    public function get(
        string $uri,
        array $queryParams = [],
    ): Response|PromiseInterface;
}

Methods at a glance

Method	Accepts	Returns
`request()`	Method, URI, body, content type, options	Response or promise
`sendRequest()`	Method, URI, options	Response or promise
`get()`	URI, query parameters	Response or promise
`head()`	URI	Response or promise
`options()`	URI	Response or promise
`post()`	URI, body, content type	Response or promise
`put()`	URI, body, content type	Response or promise
`patch()`	URI, body, content type	Response or promise
`delete()`	URI, body, content type	Response or promise
`stream()`	Method, URI, options	`StreamedResponse`
`sse()`	Method, URI, options	`EventSource`

post(), put(), patch(), and delete() accept the URI, optional body, and content type. head() and options() accept the URI.

Streaming uses separate methods:

php

interface RequestExecutor
{
    public function stream(
        Method|string $method = Method::GET,
        string $uri = '',
        array $options = [],
    ): StreamedResponse;

    public function sse(
        Method|string $method = Method::GET,
        string $uri = '',
        array $options = [],
    ): EventSource;
}

Configuration

RequestConfigurator provides withToken(), withAuth(), withHeaders(), withHeader(), withBody(), withJson(), withFormParams(), withMultipart(), withQueryParameters(), withQueryParameter(), timeout(), withOptions(), withOption(), baseUri(), withClonedOptions(), reset(), and option/header inspection methods. Other methods configure proxy, cookies, redirects, TLS, and streaming.

RetryableHandler provides retry(), retryStatusCodes(), retryExceptions(), and getters. Retry delay is measured in milliseconds; retry counts are additional attempts after the first request.

CacheableRequestHandler provides withCache(), withoutCache(), getCache(), and isCacheEnabled(). Caching requires an attached cache manager.

DebuggableHandler provides withLogLevel(), debug(), setLogger(), withProfiler(), and withDebug().

PromiseHandler provides async(), isAsync(), wrapAsync(), awaitPromise(), all(), race(), any(), sequence(), resolve(), reject(), map(), then(), catch(), and finally().

Async requests use a ReactPHP-compatible AsyncTransport. The default client uses cURL multi; custom Guzzle clients must supply their transport explicitly. setAsyncTransport(AsyncTransport $transport) replaces that bridge.

The concrete handler also provides withRequestSchema(mixed $schema), withResponseSchema(mixed $schema), withOpenApiSpec(string $path), and validateContracts(bool $validate = true). These are opt-in; see validation for optional adapters and per-request options.

See middleware and events. Pool and DNS configuration is deprecated since 4.1.0. Those services are not integrated into request execution; see HTTP/2 and legacy pool APIs.

Fetch\Http\ClientHandler ​

Request execution ​

request() ​

sendRequest() and get() ​

Methods at a glance ​

Configuration ​