PHP调用gRPC需原生安装grpc和protobuf扩展并正确配置，用protoc+grpc_php_plugin生成客户端存根，Channel必须显式创建并复用，调用后须检查$status['code']判断状态。
PHP 调用 gRPC 服务不是「装个 Composer 包就能跑」的事——grpc 和 protobuf 扩展必须原生加载，否则 Grpc\Channel 类根本不存在，任何客户端代码都会 fatal error。
grpc 和 protobuf 扩展必须编译安装，不能只靠 Composer
Composer 安装 grpc/grpc 或 google/protobuf 只是提供部分 PHP 辅助类，不提供核心 C 扩展。没装原生扩展，new UserServiceClient() 会直接报错：Class 'Grpc\Channel' not found。
- Linux 下用
pecl install grpc+pecl install protobuf，然后在php.ini中加两行：extension=grpc.so和extension=protobuf.so - macOS（Homebrew PHP）要确认
php -m | grep grpc有输出；若无，可能需重装 PHP 并启用扩展 - Windows 用户必须下载对应 PHP 版本和线程安全（TS/NTS）的
.dll文件，放进ext/目录并显式配置路径，如：extension="D:\php\ext\php_grpc.dll" - 装完务必重启 PHP-FPM 或 Apache，再执行
php -m验证
protoc 必须配合 grpc_php_plugin 生成 client stub
只用 protoc --php_out=. 会生成消息类（User.php），但不会生成客户端存根（UserGrpc.php）。缺少后者，UserServiceClient 类根本不存在。
- 必须显式指定插件：
protoc --php_out=. --grpc_out=. --plugin=protoc-gen-grpc=`which grpc_php_plugin` user.proto -
grpc_php_plugin需提前编译：从grpc源码目录执行make grpc_php_plugin，生成文件通常在bins/opt/grpc_php_plugin - 生成的 PHP 文件按
package声明自动划分命名空间，比如package example;→example\UserRequest，别漏掉require_once 'GPBMetadata/User.php'和require_once 'example/UserGrpc.php'
Channel 构造必须传 Grpc\Channel 实例，不是字符串地址
常见错误写法：new UserServiceClient('127.0.0.1:50051', [...]) —— 这会触发严格类型错误：Argument 1 passed to UserServiceClient::__construct() must be an instance of Grpc\Channel。
立即学习“PHP免费学习笔记（深入）”；
- 正确写法分两步：
$channel = new \Grpc\Channel('127.0.0.1:50051', ['credentials' => \Grpc\ChannelCredentials::createInsecure()]); $client = new \example\UserServiceClient($channel); - host 必须和服务端监听地址完全一致：填
localhost可能走 IPv6，而 Go 服务默认 bind127.0.0.1（IPv4），直接换127.0.0.1更稳妥 - 服务端启用了 TLS？那必须用
\Grpc\ChannelCredentials::createSsl()，否则连接立刻失败，错误信息是failed to connect to all addresses -
Channel是长连接，建议全局复用，不要每次请求都new一个
调用返回不抛异常，状态必须手动检查 $status
PHP gRPC 的设计哲学是「不抛异常」，所有错误都收敛到 $status 数组里。忽略它，等于把超时、拒绝连接、服务端 panic 全当成功处理。
- 同步调用写法：
list($response, $status) = $client->GetUser($request)->wait(); - 判断是否成功不能只看
$response是否为空，必须检查：if ($status['code'] === \Grpc\STATUS_OK) - 常见错误码：
\Grpc\STATUS_UNAVAILABLE（连接失败）、\Grpc\STATUS_DEADLINE_EXCEEDED（超时）、\Grpc\STATUS_INTERNAL（服务端崩溃） - 超时由
Channel构造时第二个参数控制：['timeout' => 5]单位是秒；不设就是无限等待
最易被跳过的环节是 Channel 实例化和 $status 解包——这两处出错不会报语法错误，而是静默失败或连接卡死，调试时得盯住 php -m 输出、protoc 命令完整性和 $status['code'] 的实际值。
