werkint/reactphp-http-client

Asynchronous HTTP client library.

HttpClient Component

, _(*1)

Basic HTTP/1.0 client., _(*2)

Basic usage

Requests are prepared using the Client#request() method. Body can be sent with Request#write(). Request#end() finishes sending the request (or sends it at all if no body was written)., _(*3)

Request implements WritableStreamInterface, so a Stream can be piped to it. Response implements ReadableStreamInterface., _(*4)

Interesting events emitted by Request:, _(*5)

• response: The response headers were received from the server and successfully parsed. The first argument is a Response instance.
• error: An error occurred.
• end: The request is finished. If an error occurred, it is passed as first argument. Second and third arguments are the Response and the Request.

Interesting events emitted by Response:, _(*6)

• data: Passes a chunk of the response body as first argument and a Response object itself as second argument. When a response encounters a chunked encoded response it will parse it transparently for the user of Response and removing the Transfer-Encoding header.
• error: An error occurred.
• end: The response has been fully received. If an error occurred, it is passed as first argument.

Example

<?php

$loop = React\EventLoop\Factory::create();

$dnsResolverFactory = new React\Dns\Resolver\Factory();
$dnsResolver = $dnsResolverFactory->createCached('8.8.8.8', $loop);

$factory = new React\HttpClient\Factory();
$client = $factory->create($loop, $dnsResolver);

$request = $client->request('GET', 'https://github.com/');
$request->on('response', function ($response) {
    $response->on('data', function ($data, $response) {
        // ...
    });
});
$request->end();
$loop->run();

See also the examples., _(*7)

TODO

• gzip content encoding
• keep-alive connections
• following redirections