PHP gRPC 客户端需先安装 grpc 和 protobuf 扩展，再用 protoc + grpc_php_plugin 生成 stub，Channel 地址须与服务端监听地址严格一致，Client 构造函数首参必须为 Channel 实例，错误通过 $status 数组判断而非异常。
PHP gRPC 客户端必须先装好 grpc 和 protobuf 扩展
没装扩展，composer require grpc/grpc 装再多包也没用——PHP 进程根本识别不了 Grpc\Channel 这类类。Linux 下通常要编译安装：pecl install grpc 和 pecl install protobuf，然后在 php.ini 里加两行：extension=grpc.so 和 extension=protobuf.so。macOS 用 Homebrew 装的 PHP 可能默认没开，得确认 php -m | grep grpc 有输出。
生成 PHP 客户端 stub 必须用 protoc + grpc_php_plugin
只用官方 protoc 编译 .proto 文件，会报错：找不到 Google\Protobuf\Internal\Message 或方法不存在。必须显式指定插件：
protoc --php_out=src/ --grpc_out=src/ --plugin=protoc-gen-grpc=`which grpc_php_plugin` helloworld.proto生成的 PHP 类默认放在
src/ 下，命名空间按 package 声明走，比如 package helloworld; 就对应 Helloworld\。别漏掉 --grpc_out，否则只有 message 类，没有 client 类。
Grpc\Channel 的 host:port 必须和服务端监听地址完全一致
常见错误是本地调试时填 localhost:50051，但服务端实际 bind 在 0.0.0.0:50051 或 127.0.0.1:50051——gRPC PHP 客户端对 host 解析很敏感，localhost 可能走 IPv6，而服务端只监听 IPv4。直接换 127.0.0.1:50051 试试；如果服务端启用了 TLS，还得传 ['credentials' => Grpc\ChannelCredentials::createSsl()]，否则连接立刻失败，错误信息是 failed to connect to all addresses。
调用时别直接 new Client 类，要用 new Channel 显式传参
生成的 client 类构造函数第一个参数是 Channel 实例，不是字符串地址。写成 new GreeterClient('127.0.0.1:50051', [...]) 会报错：Argument 1 passed to GreeterClient::__construct() must be an instance of Grpc\Channel。正确写法：
$channel = new \Grpc\Channel('127.0.0.1:50051', []);<br>$client = new \Helloworld\GreeterClient($channel);注意 Channel 是长连接，建议复用，别每次调用都 new 一个。超时控制靠第二个参数数组里的 'timeout' => 5（单位秒），不设就是永久阻塞。
立即学习“PHP免费学习笔记（深入）”；
真正麻烦的是错误传播方式：gRPC PHP 不抛异常，而是把状态塞进回调的 $status 数组里，$status['code'] !== 0 才算失败，且 $status['details'] 才是业务错误信息——这点和 REST 完全不同，很容易漏判。
