在workerman 4.0.10中快速搭建稳定可调试rpc通信，需安装tinywan/rpc插件并遵循协议层约定：执行composer require tinywan/rpc（若缺workerman则先装workerman/workerman），定义无类型声明的public方法服务类，路径与命名空间严格一致，再通过start_rpc.php启动服务端。
要在 Workerman 4.0.10 环境下快速搭建两个服务之间稳定、可调试的 RPC 通信，必须绕过手动序列化/反序列化和连接管理的重复劳动，直接基于协议层约定与框架生命周期对齐的调用路径实现端到端打通。
安装并初始化 tinywan/rpc 插件
进入你的 Webman 或纯 Workerman 项目根目录，执行 Composer 命令安装官方维护的轻量 RPC 插件：
composer require tinywan/rpc
该插件专为 Workerman 4.x 设计，兼容 PHP 8.2+，不依赖任何外部注册中心即可完成点对点调用。若提示 【Class 'Workerman\Worker' not found】，说明你尚未安装 workerman/workerman 包，请先运行 composer require workerman/workerman。
安装完成后，插件会自动注册服务发现机制，无需修改 autoload 或手动 require。
定义服务端接口与实现类
在项目根目录下创建 service/User.php：
namespace service;
class User {
public function getInfo($args) {
return ['code' => 0, 'msg' => 'success', 'data' => $args];
}
}
注意：方法名必须是 public，且不能带类型声明（如 string $name），否则 RPC 反射调用会因签名不匹配而静默失败。
服务类文件路径需严格对应命名空间，例如 service/User.php → namespace service；若放错目录或命名空间不一致，客户端将始终返回“service not found”错误。
启动 RPC 服务端
新建 start_rpc.php 文件，内容如下：
require_once __DIR__ . '/vendor/autoload.php';
use Workerman\Worker;
use Tinywan\Rpc\Server;
$server = new Server('tcp://0.0.0.0:9512');
$server->setServicePath(__DIR__ . '/service');
$server->run();
执行 php start_rpc.php start -d 启动服务。此时服务监听在 9512 端口，支持 TCP 连接，不启用 TLS，也不校验 client IP。
若启动报错 “Address already in use”，请检查是否已有其他进程占用了 9512 端口，可用 lsof -i :9512（macOS/Linux）或 netstat -ano | findstr :9512（Windows）定位并 kill 对应进程。
客户端发起同步调用
第一步：准备请求参数结构
客户端必须按协议要求构造数组，键名固定为 class、method、args，其中 class 值为小写服务名（User → user），method 为方法名，args 必须是数组（即使无参也要传 []）。
第二步：建立连接并发送
$client = stream_socket_client('tcp://127.0.0.1:9512', $errno, $errstr, 3);
if (!$client) { throw new Exception("RPC connect failed: $errstr"); }
$request = ['class' => 'user', 'method' => 'getInfo', 'args' => [['uid' => 1001]]];
fwrite($client, json_encode($request) . "\n");
第三步：读取并解析响应
$response = fgets($client);
fclose($client);
$result = json_decode($response, true);
var_dump($result);
这一步操作起来很简单，直接把文件拖进去就行。但要注意：每次 fwrite 后必须加 \n 换行符，否则服务端无法识别完整包边界，会导致阻塞等待超时；响应体也是以 \n 结尾的 JSON 字符串，用 fgets 才能正确截断，用 fread 会读取不全。
