引言：跨应用通信的痛点
随着业务的增长和系统复杂度的提升，我们常常需要将一个庞大的应用拆分成多个独立的微服务，或者与外部系统进行数据交互。在这种场景下，服务间的通信效率和协议标准化就显得尤为重要。传统的RESTful API固然强大，但在需要执行特定远程过程调用的场景下，它可能显得有些笨重，例如，一个简单的“获取用户信息”或“提交订单”操作，如果每次都构建一个完整的RESTful资源，会增加不必要的复杂性。
遭遇的困境：重复造轮子与协议规范
我曾经尝试在没有专门库的情况下，手动实现PHP应用间的RPC通信。起初，这似乎很简单：客户端发送一个包含方法名和参数的JSON字符串，服务端接收后解析，执行相应逻辑，再返回结果。但很快，我便遇到了各种棘手的问题：
- 协议规范缺失：自定义的JSON格式导致与不同系统对接时，需要反复调整和适配，效率低下。
- 错误处理混乱：如何优雅地表示RPC调用失败？不同的错误码、错误信息如何统一？
- 通知与请求的区分：有些调用不需要返回结果（如日志记录），如何处理这种“通知”模式？
- 批处理的复杂性：如果需要一次性发送多个RPC请求，如何高效地组织和响应？
- 代码冗余：每次实现新的RPC接口，都需要编写大量的解析、验证和响应逻辑，重复劳动严重，且容易引入bug。
这些问题让我意识到，我正在重复发明轮子，而且这个轮子还不够圆。我迫切需要一个标准化、轻量级的协议来解决这些问题，并希望PHP社区能有成熟的解决方案。
立即学习“PHP免费学习笔记（深入）”；
救星登场：datto/json-rpc与Composer的魔力
在一次偶然的搜索中，我发现了JSON-RPC 2.0协议。它是一个轻量级的远程过程调用协议，基于JSON格式，简单易懂，并且提供了清晰的请求、响应、错误和通知规范。这正是我的项目所需要的！
紧接着，我找到了一个名为datto/json-rpc的PHP库。它完全实现了JSON-RPC 2.0规范，并且拥有100%的单元测试覆盖，这让我对其质量和可靠性充满信心。最吸引我的是，它只专注于协议本身，不绑定任何传输层，这意味着我可以自由选择HTTP、SSH或其他任何方式来发送和接收JSON-RPC消息。
使用Composer安装datto/json-rpc简直是轻而易举：
composer require "datto/json-rpc"
这条命令会将库及其所有依赖项自动下载并安装到你的项目中，省去了手动管理文件和路径的麻烦。
如何使用datto/json-rpc解决问题
datto/json-rpc库为我们提供了清晰的API来创建和处理JSON-RPC消息。
1. 构建JSON-RPC客户端请求
假设我们需要调用一个远程服务上的add方法，并传递两个参数1和2。使用datto/json-rpc的Client类，代码可以非常简洁：
<?php require 'vendor/autoload.php'; // 引入Composer自动加载
use Datto\JsonRpc\Client;
$client = new Client();
// 发送一个ID为1的请求，调用'add'方法，参数为[1, 2]
$client->query(1, 'add', array(1, 2));
// 将请求对象编码为JSON字符串，准备发送
$message = $client->encode();
echo $message;
// 预期输出: {"jsonrpc":"2.0","method":"add","params":[1,2],"id":1}
// 如果是通知，则ID为null
$client->query(null, 'log', ['message' => 'User logged in']);
$notificationMessage = $client->encode();
echo $notificationMessage;
// 预期输出: {"jsonrpc":"2.0","method":"log","params":{"message":"User logged in"}}通过Client类，我们无需关心JSON-RPC请求的结构，只需指定方法名、参数和请求ID，库就会自动生成符合规范的JSON字符串。
2. 处理JSON-RPC服务端请求
在服务端，我们需要一个API接口来处理客户端发来的请求。datto/json-rpc的Server类负责解析传入的JSON-RPC消息，并调用你定义的业务逻辑。
首先，你需要定义一个API类，其中包含客户端可以调用的方法。例如：
server.php
