JSON-RPC 2.0 client/server implementation

Installs: 24 822

Dependents: 1

Stars: 22

Watchers: 5

Forks: 12

Open Issues: 6

Language: PHP

v1.0.3 2012-11-30 21:43 UTC


Build Status

A PHP implementation for JSON-RPC (v2). Contains client and server libraries to handle requests including notification and batch.



JSON-RPC is a protocol that allows servers to talk to each other using json-encoded structures. It is described in its specification as:

A light weight remote procedure call protocol. It is designed to be simple!

Full details at jsonrpc.org. You may need to read this to get an overview of the json structures that are used, although the heavy lifting is abstracted away by this implementation. For example, calling a method on a remote server is as simple as:

$client = new JsonRpc\Client($url);
$client->call('method', array($param1, $param2));

// now do something with $client->result

And at the server end:

// MethodsClass contains the exposed methods
$methods = new MethodsClass();

$server = new JsonRpc\Server($methods);


The easiest way is through composer. Just create a composer.json file and run php composer.phar install to install it:

    "minimum-stability": "dev",
    "require": {
        "jsonrpc/jsonrpc": "1.0.*"

Alternatively, you can download and extract it, or clone this repo. If you just want to try it, see Example.


If you downloaded the library through composer then you must add the following somewhere in your bootstrap code:

 require 'vendor/autoload.php';

Otherwise you must point a PSR-0 autoloader to the src directory. Full usage documentation can be found in the Wiki:


The quickest way to get the library up and running locally is to point your browser to example/client.php and everything will load automatically. You can then experiment with the code as you read the documentation.


Json-Rpc is licensed under the MIT License - see the LICENSE file for details