moaction/jsonrpc-common

Jsonrpc common libraries

v1.5 2013-12-18 09:32 UTC

Requires

• php: >=5.3.3

Requires (Dev)

• phpunit/phpunit: 3.7.*

MIT

• Alexey Kalinin

README

Common libraries for JSON-Rpc 2.0 protocol implementation

http://www.jsonrpc.org/specification

Libraries are used in jsonrpc-client and jsonrpc-server

Request

class \Moaction\Jsonrpc\Common\Request

Fields (getters and setters for fields):

• method
• id
• params

Methods

• toArray()

$request = new \Moaction\Jsonrpc\Common\Request
$request->setId(1);
$request->setMethod('getUserData');
$request->setParams(array('userId' => 4, 'field' => 'email'));
// here you get valid jsonrpc 2.0 request object ready for json_encode
// \InvalidArgumentException can be thrown when Request object is misconfigured (method is not set).
$data = $request->toArray();

Response

class \Moaction\Jsonrpc\Common\Response

Fields (getters and setters for fields):

• result
• error
• id

Methods

• fromArray()
• hasError()

Normal response

// decoded array with jsonrpc 2.0 response
$data = array(
    'id'     => 1,
    'result' => array(
        'email' => '[e-mail]',
    ),
);
// \Moaction\Jsonrpc\Common\Exception can be thrown when object is not valid jsonrpc response
$response = new \Moaction\Jsonrpc\Common\Response::fromArray($data);

Error response

// decoded array with jsonrpc 2.0 response
$data = array(
    'id'     => 1,
    'error' => array(
        'code' => '20',
        'message' => 'User not found',
        'data' => array('userId' => 4),
    ),
);
$response = new \Moaction\Jsonrpc\Common\Response::fromArray($data);
// \Moaction\Jsonrpc\Common\Error object
$error = $response->getError();

Error

class \Moaction\Jsonrpc\Common\Error

Error object. See response for example.

Exception

class \Moaction\Jsonrpc\Common\Exception

Exception for using in jsonrpc libraries