werkint/reactphp-http-client

This package is abandoned and no longer maintained. The author suggests using the werkint/reactphp-http-client package instead.

Asynchronous HTTP client library.

v0.4.14 2016-10-28 18:03 UTC

README

Build Status Code Climate

Basic HTTP/1.0 client.

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).

Request implements WritableStreamInterface, so a Stream can be piped to it. Response implements ReadableStreamInterface.

Interesting events emitted by Request:

  • 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:

  • 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.

TODO

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