服务发现与部署
默认的节点管理器使用 Swoole Table,同一个宿主 Server 的进程可以共享节点记录。独立运行的服务与网关可以通过 UDP 通告交换节点,或通过 RpcDependencies 注入使用外部注册中心的节点管理器。
在可信内网中启用 UDP 发现
本机验证时,在服务提供方首次配置 MyRpc 的 RpcConfig 中加入以下配置。记得导入 EasySwoole\Rpc\Config\DiscoveryConfig。
discovery: new DiscoveryConfig(
broadcast: true,
broadcastAddresses: ['127.0.0.1:9600'],
broadcastIntervalMs: 1000,
),
在单独的网关应用中定义相同的 MyRpc 子类。在网关的 mainServerCreate() 中加入以下导入和方法体。网关的 HTTP 监听端口要与提供方的 HTTP 端口区分开。
use App\Rpc\MyRpc;
use EasySwoole\EasySwoole\ServerManager;
use EasySwoole\EasySwoole\Swoole\EventRegister;
use EasySwoole\Rpc\Config\DiscoveryConfig;
use EasySwoole\Rpc\Config\RpcConfig;
use EasySwoole\Rpc\Config\SecurityConfig;
public static function mainServerCreate(EventRegister $register): void
{
MyRpc::getInstance(new RpcConfig(
discovery: new DiscoveryConfig(
listen: true,
listenAddress: '127.0.0.1',
listenPort: 9600,
),
security: new SecurityConfig(apiKey: 'local-demo-key'),
));
MyRpc::getInstance()->server()->setOnRuntimeError(static function (string $message): void {
error_log('[RPC discovery] ' . $message);
});
MyRpc::getInstance()->server()->attachServer(
ServerManager::getInstance()->getSwooleServer()
);
}
网关的发现进程收到提供方心跳后,会把 User 节点写入其 Worker 共享的节点表。网关的控制器可以直接用 MyRpc::getInstance()->client()->buildRequest() 创建批次,无需手动登记固定节点。第一条通告到达前,调用可能返回 NOT_AVAILABLE_NODE。提供方异常退出时,陈旧记录最终由节点 TTL 清理。
跨机器部署
ServerConfig::listenAddress是提供方的 TCP 绑定地址。advertiseHost必须能被调用方访问,存在端口映射时用advertisePort指定对外端口。broadcastAddresses填写网关实际可达的 UDP 地址和端口。nodeId应在同一服务下保持唯一,节点 TTL 应长于心跳和广播间隔。- 通信方使用相同的
apiKey并保持时钟同步。签名校验保护消息完整性,业务数据仍以明文传输。 - 超时后服务端可能已执行 Action。给写操作启用重试前,使用业务单号或幂等键防止重复写入。
具体配置、节点接口与异常类型见 RPC 6.0.1 文档。
节点上线与下线
UDP 模式由各实例直接向配置的收件地址发送心跳,没有中心注册服务。网关的 UDP 监听可以独立启用,提供方的通告也可以独立启用。每个网关维护自己的节点视图。提供方正常停止时会发送下线通知;如果通知丢失,网关会按节点 TTL 淘汰记录。
默认的 Swoole Table 同时支持同一宿主内的共享节点表,即使 UDP 关闭也可以使用。可以在调用方的协程中查看当前列表:
use App\Rpc\MyRpc;
$nodes = MyRpc::getInstance()->getNodeManager()->getNodes('User');
空数组表示查询成功、当前没有可用节点。返回 false 表示查询失败。排查时先检查路径第一段与节点的服务名是否一致,再核对 UDP 端口、密钥和 TCP 通告地址。
多个服务和网关需要共享一个注册中心时,参考集中式注册与自定义节点管理器。