>[success] JSON-RPC 在区块链中应用比较多,但是打造微服务建议使用具有更好微服务生态的 gRPC
## JSON-RPC
是一个无状态且轻量级的远程过程调用 RPC 传送协议,其传递内容透过 JSON 为主。
## Mix JSON-RPC
基于 Swoole 协程的 JSON-RPC 库,包含服务器、客户端,同时支持 TCP、HTTP 两种协议,并具有微服务调用功能
## 组件
使用 [composer](https://www.phpcomposer.com/) 安装:
```
composer require mix/json-rpc
```
## 依赖注入配置
- [manifest/beans/jsonrpc.php](https://github.com/mix-php/mix-micro-skeleton/blob/master/manifest/beans/jsonrpc.php)
## 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);
```