Kirin 93a3391a21 init 11 ヶ月 前
..
docs 93a3391a21 init 11 ヶ月 前
src 93a3391a21 init 11 ヶ月 前
tests 93a3391a21 init 11 ヶ月 前
.editorconfig 93a3391a21 init 11 ヶ月 前
.gitignore 93a3391a21 init 11 ヶ月 前
.travis.yml 93a3391a21 init 11 ヶ月 前
CHANGELOG.md 93a3391a21 init 11 ヶ月 前
LICENSE 93a3391a21 init 11 ヶ月 前
Makefile 93a3391a21 init 11 ヶ月 前
README.rst 93a3391a21 init 11 ヶ月 前
composer.json 93a3391a21 init 11 ヶ月 前
phpunit.xml.dist 93a3391a21 init 11 ヶ月 前

README.rst

=======
RingPHP
=======

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.

.. code-block:: 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.