PHP 调用 gRPC 微服务：安装、编译与客户端实战

顾星河

发布时间：2026-10-13 | 6人浏览过

原创

在微服务架构中，PHP 作为客户端调用由 Python 等语言开发的 gRPC 后端服务是常见场景。本文详细记录了从服务器环境准备（安装 Protoc 与 gRPC 扩展）、Proto 文件编译到最终 PHP 客户端代码编写的完整流程，解决跨语言通信中的依赖管理与调用细节问题。

结果或目标

完成 PHP 环境对 gRPC 的支持，并通过标准 gRPC 协议向远程（如本地端口）的微服务发送结构化数据（如 GraphData），接收并解析返回的 JSON 格式响应数据。

准备条件

服务器环境：Linux 系统，已安装 PHP（示例中使用 PHP 8.0）。如果使用宝塔面板，需注意后续禁用函数的配置。
版本参考：grpc-1.62.0，protobuf-4.62.0，protoc 解释器（版本需兼容，示例为 26.0）。
依赖工具：Composer，wget/tar，phpize/php-config。

真实操作顺序

第1步：安装 Protoc 解释器

目的：获取将 .proto 定义文件转换为编程语言代码所需的二进制工具。

下载：从官方 GitHub Release 页面下载对应 Linux 版本的 protoc 压缩包（例如 protoc-26.0-linux-x86_64.zip）。
解压部署：将解压后的 protoc 可执行文件复制或移动到系统路径下，如 /usr/bin/。

提示：若使用宝塔面板，可先在本地电脑解压 zip 包，将里面的 bin 文件夹下的 protoc 文件上传至服务器的 /usr/bin/ 目录，操作更便捷。

验证：在终端输入 protoc --version，若有版本输出则安装成功。

第2步：手动编译安装 gRPC PHP 扩展

目的：让 PHP 内核支持 gRPC 协议和 Protobuf 序列化。

下载源码：

cd ~
wget http://pecl.php.net/get/grpc-1.62.0.tgz
tar xvf grpc-1.62.0.tgz
cd grpc-1.62.0

编译安装**（耗时较长）**：
# 替换为你实际的 phpize 路径，如 /www/server/php/80/bin/phpize /www/server/php/72/bin/phpize # 替换为你的 php-config 路径 ./configure --with-php-config=/www/server/php/72/bin/php-config make && make install

配置 php.ini**：
# 将以下行追加到你的 php.ini 文件中 echo "extension = grpc.so" >> /www/server/php/80/etc/php.ini

注意：虽然部分情况下仅 grpc.so 即可工作，但为了完整性，建议同样安装 protobuf 扩展。

cd ../protobuf-4.62.0
# 重复上述 phpize configure make 步骤
echo "extension = protobuf.so" >> /www/server/php/80/etc/php.ini

第3步：重启服务并检查

目的：使新安装的扩展生效。

重启 PHP-FPM 和 Nginx 服务。可以通过创建 phpinfo() 文件或运行 php -m | grep grpc 确认扩展已加载。

第4步：编译 Proto 文件生成 PHP 类

目的：根据定义的 .proto 接口生成 PHP 客户端和服务端存根代码。

生成基础数据结构**：
protoc --php_out=./ your-file.proto
这会在当前目录生成对应的 PHP 类文件（如 GraphData.php）及 GPBMetadata 文件夹。
生成 gRPC 客户端类**：
protoc --grpc_out=./ --plugin=protoc-gen-grpc=/path/to/grpc_php_plugin your-file.proto
若未配置环境变量，需指定 grpc_php_plugin 的路径。这将生成类似 YourServiceClient.php 的文件。

风险提示：如果宝塔面板限制了某些函数导致 Composer 无法运行，请在面板的【PHP设置】→【禁用函数】中移除 putenv 和 proc_open。

第5步：引入依赖并编写客户端代码

目的：自动化管理 gRPC 库依赖并发起实际请求。

配置 Composer**：
创建 composer.json 文件，确保自动加载了生成的 Protobuf 元数据和类：

{
    "require": {
        "grpc/grpc": "*",
        "google/protobuf": "*"
    },
    "autoload": {
        "psr-4": {
            "GPBMetadata\\": "protoc/GPBMetadata/",
            "protoc\\": "protoc/"
        }
    }
}

在终端执行 composer install 生成 vendor 目录。

编写调用代码：
新建 PHP 文件（如 grpc_client.php），引用自动生成类和 Vendor 自动加载器：

<?php
require dirname(__FILE__).'/vendor/autoload.php';
require 'protoc/GraphData.php';
require 'protoc/Node.php'; 
require 'protoc/Edge.php'; 
require 'protoc/GCNResult.php'; 
require 'protoc/GCNServiceClient.php';

function callGCNService() {
    // 1. 初始化客户端，连接本地9999端口
    $client = new GCNServiceClient('localhost:9999', [
        'credentials' => \Grpc\ChannelCredentials::createInsecure(),
    ]);
    
    // 2. 构建请求参数 (以图数据为例)
    $graphData = new GraphData();
    $node1 = (new Node())->setId("node1")->setFeatures([0.1, 0.2, 0.3]);
    $node2 = (new Node())->setId("node2")->setFeatures([0.4, 0.5, 0.6]);
    $graphData->setNodes([$node1, $node2]);
    
    $edge = (new Edge())->setSourceId("node1")->setTargetId("node2");
    $graphData->setEdges([$edge]);
    
    // 3. 发送请求并等待响应
    list($response, $status) = $client->ProcessGraph($graphData)->wait();
    
    // 4. 处理响应
    if ($status->code !== Grpc\STATUS_OK) {
        throw new Exception('gRPC Error: ' . $status->details);
    }
    
    // 5. 解析 Map 类型返回值 (PHP 无原生 map，需遍历)
    $result = [];
    foreach ($response->getNodeScores() as $key => $value) {
        $result[$key] = $value;
    }
    
    return json_encode($result);
}

简要总结

通过上述步骤，PHP 项目已成功对接 gRPC 服务。关键点在于正确安装底层 C 扩展、使用正确的插件生成 PHP 代码，以及在代码中正确处理 Protobuf 生成的复杂类型（如 Map 的遍历）。以上就是 PHP 中使用 gRPC 服务的详细内容，更多关于 PHP 微服务集成的资料请关注本站其它相关文章！