mix/json-rpc

JSON-RPC library based on Swoole coroutine, including server and client, supports both TCP and HTTP protocols

v2.2.14 2020-09-14 02:39 UTC

Requires

• php: >=7.0.0
• ext-swoole: >=4.4.4
• mix/bean: ~2.2.0
• mix/http-message: ~2.2.0
• mix/http-server: ~2.2.0
• mix/micro-register: ~2.2.0
• mix/micro-server: ~2.2.0
• mix/runtime: ~2.2.0
• mix/server: ~2.2.0
• psr/event-dispatcher: ^1.0

Requires (Dev)

• phpunit/phpunit: ^7.0.0

Apache-2.0

• liu,jian

• http
• client
• tcp
• server
• json-rpc
• jsonrpc
• coroutine
• mix
• swoole

README

基于 Swoole 协程的 JSON-RPC 库，包含服务器、客户端，同时支持 TCP、HTTP 两种协议，并具有微服务调用功能

Usage

安装：

• Swoole >= 4.4.4: https://wiki.swoole.com/#/environment

composer require mix/json-rpc

• Service

首先定义一个服务

class Calculator
{
    public const NAME = "php.micro.jsonrpc.calculator.Calculator";

    public function Sum(int $a, int $b): int
    {
        return array_sum([$a, $b]);
    }
}

• Server

创建服务器，并注册 Calculator 服务

$server  = new \Mix\JsonRpc\Server('127.0.0.1', 9234);
$class = Calculator::class;
$server->register($class);
$server->start();

扩展 HTTP 支持

$http = new \Mix\Http\Server\Server('127.0.0.1', 9235);
$http->start($server);

• Client 调用

创建客户端

$dialer = new \Mix\JsonRpc\Client\Dialer();
$conn   = $dialer->dial('127.0.0.1', 9234);

$request = (new \Mix\JsonRpc\Factory\RequestFactory)->createRequest('Calculator.Sum', [1, 3], 100001)
$response = $conn->call($request);
var_dump($response);

• Client 微服务调用

$dialer = new \Mix\JsonRpc\Client\Dialer([
    'registry' => new \Mix\Micro\Etcd\Registry('http://127.0.0.1:2379/v3'),
]);
$conn   = $dialer->dialFromService('php.micro.jsonrpc.calculator');

$request = (new \Mix\JsonRpc\Factory\RequestFactory)->createRequest('Calculator.Sum', [1, 3], 100001)
$response = $conn->call($request);
var_dump($response);

License

Apache License Version 2.0, http://www.apache.org/licenses/