sajya/client

HTTP client and server for JSON-RPC 2.0

1.2.0 2024-03-15 23:46 UTC

Requires

• guzzlehttp/guzzle: ^7.4
• illuminate/http: ^8.0|^9.0|^10.0|^11.0
• illuminate/support: 8.0|^9.0|^10.0|^11.0

Requires (Dev)

• orchestra/testbench: ^7.0|^8.0|^9.0
• sajya/server: ^5.2|^6.0

MIT

• tabuna

• rpc
• api
• json-prc

README

This package lets you set up a JSON-RPC client over HTTP(S), using your PHP code to make the requests. Built around Laravel (Doesn't require the entire framework, just its component) expressive HTTP wrapper, it allows you to customize things like authorization, retries, and more.

Install

Go to the project directory and run the command:

$ composer require sajya/client

Usage

use Illuminate\Support\Facades\Http;
use Sajya\Client\Client;

$client = new Client(Http::baseUrl('http://localhost:8000/api/v1/endpoint'));

$response = $client->execute('tennis@ping');

$response->result(); // pong

By default, the request identifier will be generated using the UUID, you can get it by calling the id() method

$response->id();

To get the result of an error, you need to call the error() method

$response->error();

Parameters

Example with positional parameters:

$response = $client->execute('tennis@ping', [3, 5]);

Example with named arguments:

$response = $client->execute('tennis@ping', ['end' => 10, 'start' => 1]);

Batch requests

Call several procedures in a single HTTP request:

$batchData = $client->batch(function (Client $client) {
    $client->execute('tennis@ping');
    $client->execute('tennis@ping');
});

Notify requests

$client->notify('procedure@method');

License

The MIT License (MIT). Please see License File for more information.