RingPHP tests client handlers using PHPUnit and a built-in node.js web server.
First, install the dependencies using Composer.
Next, run the unit tests using
The tests are also run on Travis-CI on each commit: https://travis-ci.org/guzzle/guzzle-ring
Testing client handlers usually involves actually sending HTTP requests. RingPHP provides a node.js web server that returns canned responses and keep a list of the requests that have been received. The server can then be queried to get a list of the requests that were sent by the client so that you can ensure that the client serialized and transferred requests as intended.
The server keeps a list of queued responses and returns responses that are popped off of the queue as HTTP requests are received. When there are not more responses to serve, the server returns a 500 error response.
The test server uses the
GuzzleHttp\Tests\Ring\Client\Server class to
control the server.
use GuzzleHttp\Ring\Client\StreamHandler; use GuzzleHttp\Tests\Ring\Client\Server; // First return a 200 followed by a 404 response. Server::enqueue([ ['status' => 200], ['status' => 404] ]); $handler = new StreamHandler(); $response = $handler([ 'http_method' => 'GET', 'headers' => ['host' => [Server::$host]], 'uri' => '/' ]); assert(200 == $response['status']); $response = $handler([ 'http_method' => 'HEAD', 'headers' => ['host' => [Server::$host]], 'uri' => '/' ]); assert(404 == $response['status']);
After requests have been sent, you can get a list of the requests as they were sent over the wire to ensure they were sent correctly.
$received = Server::received(); assert('GET' == $received['http_method']); assert('HEAD' == $received['http_method']);