ThinkPHP 8.1 无内置 RPC 框架，但可通过 Swoole + 自定义协议或注册中心（Consul/Etcd）+ HTTP/TCP 客户端实现分布式调用；需明确 Provider、Consumer、Registry 角色，支持 HTTP RESTful（轻量易调试）与 TCP RPC（高性能）两种方式，并强调服务发现、安全熔断与链路追踪。
ThinkPHP 8.1 本身不内置完整 RPC 框架，但可通过集成 Swoole + 自定义通信协议，或借助服务注册中心（如 Consul、Etcd）+ HTTP/TCP 客户端，实现跨节点服务调用。关键不在“开箱即用”，而在明确角色分工与通信契约。
明确服务角色与通信方式
分布式调用需先厘清三个基础角色：
-
Provider（服务提供方）：暴露接口，例如用户服务运行在
user-service:9501，提供/api/user/infoHTTP 接口或自定义 TCP 协议方法 - Consumer（服务消费方）：发起调用，例如订单服务需获取用户信息，不再直连数据库，而是向 user-service 发起远程请求
- Registry（注册中心，可选但推荐）：记录服务地址，避免硬编码 IP 和端口；Think-Swoole 的服务发现仅限本地扫描，不替代分布式注册中心
两种主流落地方式
根据项目规模和运维能力选择：
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
-
HTTP RESTful 调用（轻量、易调试）：
Provider 使用 ThinkPHP 8.1 + Swoole 启动长连接 HTTP 服务（非传统 FPM），开放标准 API；Consumer 用think\Http或GuzzleHttp\Client发起请求，并配合重试、超时、熔断中间件。适合初期微服务拆分或异构系统互通。 -
TCP RPC 调用（高性能、低延迟）：
基于think-swoole提供的Swoole\Server和Swoole\Client实现二进制或 JSON-RPC 协议；Provider 启动 TCP Server 监听端口，Consumer 封装 Client 类统一管理连接池与序列化。需自行处理服务发现（如从配置中心拉取地址列表）、心跳保活、负载均衡（轮询/随机）。
服务发现与地址管理
避免写死 IP 和端口，推荐以下组合：
立即学习“PHP免费学习笔记（深入）”；
- 开发阶段：用
config/services.php配置各服务地址，例如：'user' => ['host' => 'user-service', 'port' => 9501, 'timeout' => 3.0]，配合 Docker Compose 的 service name 自动 DNS 解析 - 生产环境：接入 Consul，Consumer 启动时通过 HTTP API 查询
user-service的健康实例列表，缓存并定时刷新；可封装为ServiceDiscovery类注入容器 - 注意：
php think service:discover命令仅用于扫描本地模块并注册到框架内部服务容器，不适用于跨进程/跨机器的服务发现
调用安全与稳定性保障
跨节点通信必须考虑失败场景：
- Consumer 端统一封装调用入口，强制设置
connect_timeout=1.0、read_timeout=2.0，防止阻塞主线程 - 对非幂等调用（如创建订单）启用本地事务 + 最终一致性补偿（如消息队列回调核验）
- 添加简易熔断器：连续 3 次超时或 5xx 错误达阈值后，自动降级返回默认数据或抛出特定异常，5 秒后试探恢复
- 所有远程调用日志需记录 trace_id、service_name、url、status_code、cost_ms，便于链路追踪
