PHP微服务RPC调用参数拼接须严格遵循契约：Hyperf要求索引数组按序传参；Webman要求args为单元素二维数组；Swoole需JSON编码加换行符并Base64处理二进制数据。
在微服务架构中，PHP框架拼接RPC调用参数必须严格匹配服务契约定义的参数顺序、类型与嵌套结构，否则反序列化失败或方法调用被拒绝。
Hyperf 3.0 中按契约接口拼接 JSON-RPC 参数
Hyperf 要求消费者端构造的请求参数必须与服务提供者接口中声明的参数签名完全一致，包括键名、类型、是否可为空、嵌套层级。
第一步：打开共享 Composer 包中的服务接口文件，例如 App\JsonRpc\CalculatorServiceInterface，确认方法签名：public function add(int $a, int $b): int;
第二步：使用 Yar_Client 或自定义 HTTP 客户端发起调用时，参数必须以索引数组形式传入，【不能用关联数组键名映射】，因为 JSON-RPC 2.0 规范要求 params 字段为有序数组：$client->add([5, 12]); // ✅ 正确；$client->add(['a' => 5, 'b' => 12]); // ❌ 失败
立即学习“PHP免费学习笔记（深入）”；
第三步：若接口含可空参数（如 int|null $c = null），必须显式传入 null 占位，不可省略：$client->calculate([10, 20, null]); // 第三个参数为 null，不可写成 [10, 20]
Webman RPC 插件中拼接 TCP 文本协议参数
Webman 的 RPC 插件采用自定义 Text 协议，要求参数必须包裹在二维数组中，且外层数组必须有 args 键。
方法一：基础单参数调用$request = ['class' => 'user', 'method' => 'get', 'args' => [['uid' => 1001]]];
方法二：多参数+深层嵌套（如用户创建需传入地址对象）$request = [ 'class' => 'user', 'method' => 'create', 'args' => [[ 'name' => '李四', 'profile' => ['city' => '杭州', 'tags' => ['vip', 'active']] ]] ];
注意：【args 必须是长度为 1 的数组，其唯一元素才是实际参数容器】，这是 Webman RPC 协议硬性约定，错写成 'args' => [...]（无外层包裹）会导致服务端解析出错并静默丢弃请求。
Swoole 原生实现中手动序列化参数
当不依赖框架封装、直接基于 Swoole Server/Client 构建 RPC 时，参数拼接完全由开发者控制，但需自行处理边界与编码。
第一步：将参数数组统一用 json_encode($params, JSON_UNESCAPED_UNICODE) 编码，避免中文变 \uXXXX。
第二步：在 JSON 字符串末尾追加换行符 "\n"，Swoole 文本协议靠它识别消息边界，漏掉会导致后续所有请求粘包。
第三步：若参数含二进制数据（如图片 base64 字符串），必须先 Base64 编码再 JSON 序列化，否则 JSON 解析会因非法字符中断。
