在我的Web应用开发生涯中，构建API接口是家常便饭。起初，RESTful API似乎是万能的，但随着项目复杂度的提升，我发现对于一些简单的“方法调用”型操作，RESTful的资源抽象有时显得过于笨重。例如，我可能只是想让客户端调用服务器上的一个 calculateSum(a, b) 方法，却不得不设计 /api/calculator/sum 这样的URI，并处理GET/POST请求体中的参数。这不仅增加了开发和维护的复杂度，也让接口的意图变得不那么直接。我迫切需要一种更直接、更规范的方式，让客户端能够像调用本地函数一样调用服务器端的方法，同时又不想从零开始处理JSON解析、错误处理和协议规范。
这种需求其实就是远程过程调用（RPC）的经典场景。而JSON-RPC，作为一种轻量级的RPC协议，以其简洁的JSON格式和明确的调用规范，成为了许多开发者青睐的选择。然而，手动实现一个符合JSON-RPC 2.0规范的服务器端，包括请求解析、方法分发、参数校验、错误响应构建等，仍然是一项不小的工程，容易出错且耗时。
就在我为如何优雅地实现JSON-RPC服务而苦恼时，我遇到了 laminas/laminas-json-server。这个由Laminas项目维护的Composer库，为PHP开发者提供了一个成熟、稳定且功能完备的JSON-RPC服务器实现，它彻底改变了我构建远程服务接口的方式。
使用Composer引入 laminas/laminas-json-server 库非常简单，只需一条命令：
composer require laminas/laminas-json-server
Laminas Json-Server 的核心思想是将你的PHP类或对象的方法，通过简单的配置，暴露为可以通过HTTP请求调用的远程服务。它会自动处理传入的JSON-RPC请求，解析方法名和参数，调用对应的PHP方法，并将结果以符合JSON-RPC规范的响应格式返回。
假设我们有一个简单的计算器服务类：
// Calculator.php
class Calculator
{
/**
* Adds two numbers.
* @param int $a
* @param int $b
* @return int
*/
public function add(int $a, int $b): int
{
return $a + $b;
}
/**
* Subtracts two numbers.
* @param int $a
* @param int $b
* @return int
*/
public function subtract(int $a, int $b): int
{
return $a - $b;
}
}现在，我们可以在入口文件（例如 index.php）中轻松地将其转换为一个JSON-RPC服务：
// index.php
require 'vendor/autoload.php';
use Laminas\Json\Server\Server;
// 创建Calculator服务实例
$calculator = new Calculator();
// 创建JSON-RPC服务器
$server = new Server();
// 将Calculator服务附加到服务器
$server->setClass($calculator);
// 检查是否是POST请求，并且请求头包含 'application/json'
if ('POST' == $_SERVER['REQUEST_METHOD'] && isset($_SERVER['HTTP_CONTENT_TYPE']) && str_contains($_SERVER['HTTP_CONTENT_TYPE'], 'application/json')) {
// 处理请求并输出响应
$server->handle();
} else {
// 如果不是JSON-RPC请求，可以输出服务描述或错误信息
header('Content-Type: application/json');
echo json_encode(['error' => 'Invalid request method or content type. Please send a JSON-RPC POST request.']);
}现在，客户端就可以发送一个JSON-RPC请求来调用 add 方法了：
// 客户端请求示例 (POST到 index.php)
{
"jsonrpc": "2.0",
"method": "add",
"params": [5, 3],
"id": 1
}服务器会返回：
// 服务器响应示例
{
"jsonrpc": "2.0",
"result": 8,
"id": 1
}Laminas Json-Server 还会自动处理方法不存在、参数错误等情况，并返回标准的JSON-RPC错误响应，这极大地增强了API的健壮性。
使用 laminas/laminas-json-server 带来的好处是显而易见的：
- 高度标准化：严格遵循JSON-RPC 2.0规范，确保了服务间的互操作性，无论是Web前端、移动应用还是其他服务，都能轻松对接。
- 开发效率提升：你无需关心底层协议解析、参数校验和响应构建，只需专注于业务逻辑的实现，大幅减少了重复性工作。
- 简洁明了：相比复杂的RESTful路由和资源设计，JSON-RPC在方法调用场景下更为直观，接口定义一目了然。
- 强大的错误处理：内置的错误处理机制能够自动捕获异常并生成符合规范的错误响应，让你的API更加专业和易于调试。
- 灵活性：不仅可以附加类，还可以附加函数，甚至支持服务描述（Service Map）的生成，方便客户端了解可用的服务和方法。
总而言之，如果你正在寻找一种高效、规范且易于维护的方式来构建远程服务接口，尤其是在需要明确方法调用的场景下，那么 laminas/laminas-json-server 绝对是一个值得尝试的优秀工具。它让我从繁琐的协议细节中解脱出来，能够更专注于核心业务逻辑，大大提升了开发体验和项目质量。告别手写JSON-RPC解析的烦恼，拥抱Laminas Json-Server带来的便利吧！
