Skip to content

Latest commit

 

History

History
88 lines (63 loc) · 1.89 KB

README.md

File metadata and controls

88 lines (63 loc) · 1.89 KB
Raw

JSON-RPC php

JSON-RPC protocol implementation in PHP.

Ability to create requests and responses, regardless of the protocol of the data transfer level (currently implemented only for HTTP).

Implemented classes for server and client.

Install

composer require Saiks24/json-rpc-php

Examples

Build Request

From string

$rpcRequest = '{"jsonrpc":"2.0","method":"task.create","params":{"arg1":"val1"}}';

$request = RPCRequestBuilder::getBuilder(
  Rpc::RPC_PROTOCOL_VERSION_2_0
)->createFromString($rpcRequest)
  ->build();

From PSR-7 Request

$psrRequest = new \GuzzleHttp\Psr7\ServerRequest('POST','0.0.0.0');


$request = RPCRequestBuilder::getBuilder(
  Rpc::RPC_PROTOCOL_VERSION_2_0
)->createFromPsrRequest($psrRequest);

Build custom

$request = RPCRequestBuilder::getBuilder(Rpc::RPC_PROTOCOL_VERSION_2_0)
  ->withMethod('task.create')
  ->withArgs(['arg1'=>'val1'])
  ->build();

Build Response

From PSR-7 Response

$psrResponse = new \GuzzleHttp\Psr7\Response();

$response = RPCResponseBuilder::getBuilder(
  Rpc::RPC_PROTOCOL_VERSION_2_0
)->createFromPsrResponse($psrResponse);

Build custom success

$response = RPCResponseBuilder::getBuilder(Rpc::RPC_PROTOCOL_VERSION_2_0)
  ->withResult('task created')->build();

Build custom error

$errorResponse = RPCResponseBuilder::getBuilder(
  Rpc::RPC_PROTOCOL_VERSION_2_0
)->withError(
  new \Saiks24\Rpc\Response\Error(-32600,'Invalid JSON-RPC')
)->build();

Client

$client = new \Saiks24\Rpc\Client\Client('0.0.0.0',null,new HttpSender());
$client->setRequestBody($request);
$client->sendRequest();

Server

$server = new \Saiks24\Rpc\Server\Server();
$server->setResponse($response);
$server->sendResponse(new \GuzzleHttp\Psr7\BufferStream());