datto/json-rpc

Fully unit-tested JSON-RPC 2.0 for PHP

JSON-RPC for PHP

Overview

This package allows you to create and evaluate JSON-RPC messages, using your own PHP code to evaluate the requests., _(*1)

This package allows you to create and evaluate any JSON-RPC message. It implements the JSON-RPC specifications, but does not provide a transport layer—which you'll also need if you want to send or receive messages over a distance! One of the beautiful features of JSON-RPC is that you can use any transport layer to carry your messages: This package gives you that option., _(*2)

If you're looking for an end-to-end solution, with the transport layer included, then you should use one of these alternative packages instead: * To send messages over HTTP(S), use the php-json-rpc-http package. * To send messages over SSH, use the php-json-rpc-ssh package., _(*3)

Features

• Correct: fully compliant with the JSON-RPC 2.0 specifications (100% unit-test coverage)
• Flexible: you can use your own code to evaluate the JSON-RPC method strings
• Minimalistic: extremely lightweight
• Ready to use, with working examples

Examples

Client

$client = new Client();

$client->query(1, 'add', array(1, 2));

$message = $client->encode();

// message: {"jsonrpc":"2.0","method":"add","params":[1,2],"id":1}

Server

$api = new Api();

$server = new Server($api);

$reply = $server->reply($message);

// reply: {"jsonrpc":"2.0","result":3,"id":1}

See the examples folder for full working examples., _(*4)

Requirements

• PHP >= 7.0

License

This package is released under an open-source license: LGPL-3.0, _(*5)

Installation

If you're using Composer, you can include this library (datto/json-rpc) like this:, _(*6)

composer require "datto/json-rpc"

Getting started

1. Try the examples. You can run the examples from the project directory like this:, _(*7)

   php examples/client.php
   php examples/server.php
   

2. Take a look at the code "examples/src"—then replace it with your own!, _(*8)

Unit tests

You can run the suite of unit tests from the project directory like this:, _(*9)

./vendor/bin/phpunit

Changelog

See what has changed: Changelog, _(*10)

Author

Spencer Mortensen, _(*11)