当前位置：首页 > PHP

php实现grpc

2026-02-14 16:02:43PHP

使用 gRPC 的 PHP 实现

gRPC 是一个高性能、开源的远程过程调用（RPC）框架，支持多种语言，包括 PHP。以下是实现 PHP gRPC 的步骤和关键点。

安装必要的工具和依赖

确保系统已安装 PHP 7.0 或更高版本，并安装以下依赖：

gRPC PHP 扩展：通过 PECL 安装：
```
pecl install grpc
```
在 php.ini 中添加 extension=grpc.so。
Protobuf 编译器 (protoc)：用于生成 PHP 代码。从 Protocol Buffers 官方仓库下载并安装。

gRPC PHP 插件：通过 Composer 安装：

composer require grpc/grpc
composer require google/protobuf

定义 Protobuf 服务

创建一个 .proto 文件定义服务接口。例如 hello.proto：

php实现grpc

syntax = "proto3";

package hello;

service Greeter {
  rpc SayHello (HelloRequest) returns (HelloReply) {}
}

message HelloRequest {
  string name = 1;
}

message HelloReply {
  string message = 1;
}

生成 PHP 代码

使用 protoc 生成 PHP 客户端和服务端代码：

protoc --php_out=. --grpc_out=. --plugin=protoc-gen-grpc=$(which grpc_php_plugin) hello.proto

这会生成 GPBMetadata 目录和 Hello 命名空间下的文件。

实现 gRPC 服务端

创建服务端脚本 server.php：

require __DIR__ . '/vendor/autoload.php';

class GreeterService extends \Hello\GreeterStub {
    public function SayHello(\Hello\HelloRequest $request, \Grpc\ServerContext $context): ?\Hello\HelloReply {
        $name = $request->getName();
        $reply = new \Hello\HelloReply();
        $reply->setMessage("Hello, $name");
        return $reply;
    }
}

$server = new \Grpc\RpcServer();
$server->addHttp2Port('0.0.0.0:50051');
$server->handle(new GreeterService());
$server->run();

实现 gRPC 客户端

创建客户端脚本 client.php：

php实现grpc

require __DIR__ . '/vendor/autoload.php';

$client = new \Hello\GreeterClient('localhost:50051', [
    'credentials' => \Grpc\ChannelCredentials::createInsecure(),
]);

$request = new \Hello\HelloRequest();
$request->setName('World');

list($response, $status) = $client->SayHello($request)->wait();
if ($status->code === \Grpc\STATUS_OK) {
    echo $response->getMessage();
} else {
    echo "Error: " . $status->details;
}

运行服务端和客户端

启动服务端：

php server.php

在另一个终端运行客户端：

php client.php

使用 SSL/TLS 加密（可选）

如需加密通信，生成证书并修改服务端和客户端配置：

服务端：

$credentials = \Grpc\ServerCredentials::createSsl(
    file_get_contents('server.crt'),
    [file_get_contents('server.key')],
    file_get_contents('ca.crt')
);
$server->addSecureHttp2Port('0.0.0.0:50051', $credentials);

客户端：

$credentials = \Grpc\ChannelCredentials::createSsl(
    file_get_contents('ca.crt')
);
$client = new \Hello\GreeterClient('localhost:50051', ['credentials' => $credentials]);