guzzlehttp/ring

This package is abandoned and no longer maintained. The author suggests using the guzzlehttp/ringphp package instead.

Provides a simple API and specification that abstracts away the details of HTTP into a single PHP function.

1.1.1 2018-07-31 13:22 UTC

Requires

• php: >=5.4.0
• guzzlehttp/streams: ~3.0
• react/promise: ~2.0

Requires (Dev)

• ext-curl: *
• phpunit/phpunit: ~4.0

Suggests

• ext-curl: Guzzle will use specific adapters if cURL is present

MIT

• Michael Dowling

README

Provides a simple API and specification that abstracts away the details of HTTP into a single PHP function. RingPHP be used to power HTTP clients and servers through a PHP function that accepts a request hash and returns a response hash that is fulfilled using a promise, allowing RingPHP to support both synchronous and asynchronous workflows.

By abstracting the implementation details of different HTTP clients and servers, RingPHP allows you to utilize pluggable HTTP clients and servers without tying your application to a specific implementation.

<?php
require 'vendor/autoload.php';

use GuzzleHttp\Ring\Client\CurlHandler;

$handler = new CurlHandler();
$response = $handler([
    'http_method' => 'GET',
    'uri'         => '/',
    'headers'     => [
        'host'  => ['www.google.com'],
        'x-foo' => ['baz']
    ]
]);

$response->then(function (array $response) {
    echo $response['status'];
});

$response->wait();

RingPHP is inspired by Clojure's Ring, which, in turn, was inspired by Python's WSGI and Ruby's Rack. RingPHP is utilized as the handler layer in Guzzle 5.0+ to send HTTP requests.

Documentation

See http://ringphp.readthedocs.org/ for the full online documentation.