Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/graze/guzzle-jsonrpc
JSON-RPC 2.0 client for Guzzle
https://github.com/graze/guzzle-jsonrpc
guzzle php
Last synced: 3 days ago
JSON representation
JSON-RPC 2.0 client for Guzzle
- Host: GitHub
- URL: https://github.com/graze/guzzle-jsonrpc
- Owner: graze
- License: mit
- Created: 2013-06-26T11:48:04.000Z (over 11 years ago)
- Default Branch: master
- Last Pushed: 2023-02-15T15:57:32.000Z (almost 2 years ago)
- Last Synced: 2025-01-12T14:06:13.803Z (10 days ago)
- Topics: guzzle, php
- Language: PHP
- Homepage: https://packagist.org/packages/graze/guzzle-jsonrpc
- Size: 150 KB
- Stars: 93
- Watchers: 15
- Forks: 61
- Open Issues: 6
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# [ABANDONED] Guzzle JSON-RPC
[](http://unmaintained.tech/)
### This is no longer supported, please consider forking this repository to make any desired changes.
[![Master branch build status][ico-build]][travis]
[![Coverage Status][ico-coverage]][coverage]
[![Quality Score][ico-quality]][quality]
[![Published version][ico-package]][package]
[![PHP ~5.5][ico-engine]][lang]
[![MIT Licensed][ico-license]][license]
This library implements [JSON-RPC 2.0][jsonrpc] for the Guzzle HTTP client. We
try to support all commonly used versions of Guzzle including:
- [GuzzleHTTP 6][guzzle] on [`master`][branch-master] branch, `^3.0` releases
- [GuzzleHTTP 5][guzzle] on [`guzzle-5`][branch-5] branch, `^2.1` releases
- [GuzzleHTTP 4][guzzle] on [`guzzle-4`][branch-4] branch, `2.0.*` releases
- [Guzzle 3][guzzle-3] on [`guzzle-3`][branch-3] branch, `^1.0` releases
It can be installed in whichever way you prefer, but we recommend [Composer][package].
```json
{
"require": {
"graze/guzzle-jsonrpc": "~3.0"
}
}
```
## Documentation
```php
send($client->notification('method', ['key'=>'value']));
// Send a request that expects a response
$client->send($client->request(123, 'method', ['key'=>'value']));
// Send a batch of requests
$client->sendAll([
$client->request(123, 'method', ['key'=>'value']),
$client->request(456, 'method', ['key'=>'value']),
$client->notification('method', ['key'=>'value'])
]);
```
### Async requests
Asynchronous requests are supported by making use of the
[Guzzle Promises][guzzle-promise] library; an implementation of
[Promises/A+][promise].
```php
sendAsync($client->notification('method', ['key'=>'value']));
$promise->then(function () {
// Do something
});
// Send an async request that expects a response
$promise = $client->sendAsync($client->request(123, 'method', ['key'=>'value']));
$promise->then(function ($response) {
// Do something with the response
});
// Send a batch of requests
$client->sendAllAsync([
$client->request(123, 'method', ['key'=>'value']),
$client->request(456, 'method', ['key'=>'value']),
$client->notification('method', ['key'=>'value'])
])->then(function ($responses) {
// Do something with the list of responses
});
```
### Throw exception on RPC error
You can throw an exception if you receive an RPC error response by adding the
option `[rpc_error => true]` in the client constructor.
```php
true]);
// Create a request
$request = $client->request(123, 'method', ['key'=>'value']);
// Send the request
try {
$client->send($request);
} catch (RequestException $e) {
die($e->getResponse()->getRpcErrorMessage());
}
```
### Contributing
We accept contributions to the source via Pull Request,
but passing unit tests must be included before it will be considered for merge.
```bash
~ $ make deps
~ $ make lint test
```
### License
The content of this library is released under the **MIT License** by
**Nature Delivered Ltd**.
You can find a copy of this license at
[mit][mit] or in [`LICENSE`][license]
[mit]: http://www.opensource.org/licenses/mit
[travis]: https://travis-ci.org/graze/guzzle-jsonrpc
[lang]: http://php.net
[package]: https://packagist.org/packages/graze/guzzle-jsonrpc
[coverage]: https://scrutinizer-ci.com/g/graze/guzzle-jsonrpc/code-structure
[quality]: https://scrutinizer-ci.com/g/graze/guzzle-jsonrpc
[ico-license]: http://img.shields.io/packagist/l/graze/guzzle-jsonrpc.svg?style=flat
[ico-package]: http://img.shields.io/packagist/v/graze/guzzle-jsonrpc.svg?style=flat
[ico-build]: http://img.shields.io/travis/graze/guzzle-jsonrpc/master.svg?style=flat
[ico-engine]: http://img.shields.io/badge/php-~5.5-8892BF.svg?style=flat
[ico-coverage]: https://img.shields.io/scrutinizer/coverage/g/graze/guzzle-jsonrpc.svg?style=flat
[ico-quality]: https://img.shields.io/scrutinizer/g/graze/guzzle-jsonrpc.svg?style=flat
[vagrant]: http://vagrantup.com
[jsonrpc]: http://jsonrpc.org/specification
[guzzle]: https://github.com/guzzle/guzzle
[promise]: https://promisesaplus.com
[guzzle-3]: https://github.com/guzzle/guzzle3
[guzzle-promise]: https://github.com/guzzle/promises
[branch-3]: https://github.com/graze/guzzle-jsonrpc/tree/guzzle-3
[branch-4]: https://github.com/graze/guzzle-jsonrpc/tree/guzzle-4
[branch-5]: https://github.com/graze/guzzle-jsonrpc/tree/guzzle-5
[branch-master]: https://github.com/graze/guzzle-jsonrpc
[license]: LICENSE