本文详解如何通过 php grpc pecl 扩展（非纯 php 实现）原生调用 grpc 服务，替代 shell_exec 调用 grpcurl 的方式，重点说明协议缓冲区代码生成的必要性与正确接入流程。
直接使用 BaseStub 手动构造请求并调用 _simpleRequest 是不可行的——PHP gRPC PECL 扩展不支持运行时动态解析 .proto 文件或手动序列化 JSON 字符串为 Protocol Buffer 二进制格式。它严格依赖由 .proto 文件生成的、类型安全的 PHP 客户端类（含 request/response 消息类和 service stub），所有序列化/反序列化、HTTP/2 传输、TLS 处理均由扩展底层（C++ core）自动完成。
因此，核心步骤不是“手写 stub”，而是：基于 extranet.proto 生成符合 gRPC PECL 规范的 PHP 类文件。推荐使用官方支持的代码生成工具链：
✅ 正确流程：生成强类型客户端代码
确保环境已安装 protoc 编译器（v3.15+ 推荐）
下载地址：https://www.php.cn/link/8e488eaf07b841e692fc4fe103e7b254安装 PHP gRPC 插件（已做）
确认 extension=grpc 已启用，且 php -m | grep grpc 可见输出。-
使用 protoc + gRPC PHP 插件生成代码
⚠️ 注意：不能使用 protobuf-php/protobuf-plugin（该库面向纯 PHP 实现，与 PECL gRPC 不兼容）；必须使用 grpc_php_plugin。
# Linux/macOS 示例（Windows 同理，需确保 protoc 和插件在 PATH 中） protoc \ --php_out=src/ \ --grpc_out=src/ \ --plugin=protoc-gen-grpc=/path/to/grpc_php_plugin \ -I . \ extranet.proto
✅ grpc_php_plugin 下载地址：https://www.php.cn/link/6d1eda42e54a1c2b1083d901f073529a
（Windows 用户请下载对应平台的 grpc_php_plugin.exe） -
生成结果结构示例
假设 extranet.proto 中定义了 service BuscaEmpresa 和 rpc Login(LoginRequest) returns (LoginResponse)，则生成：src/ └── Extranet/ ├── V0/ │ ├── BuscaEmpresaClient.php # Stub 客户端类 │ ├── LoginRequest.php # 请求消息类（含 setUsuario()/setSenha()） │ └── LoginResponse.php # 响应消息类 └── ... -
在 PHP 中调用（完整可运行示例）
立即学习“PHP免费学习笔记（深入）”；
<?php require_once 'vendor/autoload.php'; require_once 'src/Extranet/V0/BuscaEmpresaClient.php'; require_once 'src/Extranet/V0/LoginRequest.php'; require_once 'src/Extranet/V0/LoginResponse.php'; use Extranet\V0\BuscaEmpresaClient; use Extranet\V0\LoginRequest; // 创建客户端（禁用 TLS 验证，对应 grpcurl -insecure） $client = new BuscaEmpresaClient( 'www.jucerja.rj.gov.br:9443', [ 'credentials' => \Grpc\ChannelCredentials::createInsecure() ] ); // 构造强类型请求对象 $request = new LoginRequest(); $request->setUsuario('user'); $request->setSenha('pass'); // 发起 RPC 调用 list($response, $status) = $client->Login($request)->wait(); if ($status->code === \Grpc\STATUS_OK) { echo "Success:\n"; var_dump($response->serializeToJsonString()); // 或直接 getXXX() 访问字段 } else { echo "gRPC Error: {$status->details} (code: {$status->code})\n"; }
❗ 关键注意事项
- 绝不手动拼接 JSON 或字符串：gRPC 协议要求二进制 Protocol Buffer 序列化，JSON 只是调试表示，serializeToString() 返回的是二进制数据，不是 JSON 字符串。
- .proto 必须准确：服务端使用的 .proto 版本、包名（package extranet.v0;）、服务路径（extranet.v0.BuscaEmpresa）必须与生成代码完全一致。
- Windows 路径与权限：确保 protoc 和 grpc_php_plugin.exe 具有执行权限，且路径不含空格或中文。
-
错误排查建议：开启 gRPC 日志辅助调试：
putenv('GRPC_VERBOSITY=DEBUG'); putenv('GRPC_TRACE=all');
遵循此流程，即可完全替代 shell_exec('grpcurl.exe ...')，获得更高性能、更强类型安全及更优的错误处理能力。
