A general JSON RPC client.

Installs: 5

Dependents: 1

Watchers: 3

Forks: 1

Language: PHP

0.1.0 2013-05-17 09:22 UTC

README

A general JSON RPC implementation for PHP.

Project Wiki

GitHub Project Wiki

What's new

Version 0.2.0

  • Implementation of JSON RPC 2.0 Codec.

Version 0.1.0

  • Finished basic implementations.

Getting started

Installation

You can use Composer (http://www.getcomposer.org) to install the JSON RPC library.

{
    "require": {
        "fritz-payment/jsonrpc": "dev-master"
    }
}

Usage

This example calls a JSON RPC 1.0 method "test.echo" on the URL http://www.example.com using cURL.

<?php
use \FritzPayment\JsonRpc\Rpc\Codec\JsonRpc10;
use \FritzPayment\JsonRpc\Client\Transport\Curl;

// initialize JSON RPC 1.0 Codec
$codec = new JsonRpc10();
// initialize cURL transport
$transport = new Curl();

// initialize client
$client = new \FritzPayment\JsonRpc\Client('http://www.example.com', $codec, $transport);

// create a new request
/* @var $request \FritzPayment\JsonRpc\Rpc\Codec\JsonRpc10\Request */
$request = $client->newRequest();
$request->setMethod('test.echo')
    ->setId('1');
$request->setParams(array('test message'));

// send request
$response = $client->exec($request);
if ($response === false) {
    // failed
} else {
    if ($response->isError()) {
        // JSON RPC error
        echo $response->getError()->error();
    } else {
        var_dump($response->getResult());
    }
}

Extending the library

It is possible to create your own implementations of Transports and Codecs.

The abstract Transport and Codec classes and the existing implementations should give you an idea of how to do that.