快速入门
本指南通过一个简单的示例带您快速上手 PHP 中的 gRPC。
快速入门
先决条件
- PHP 7.0 或更高版本，PECL，Composer
- grpc 扩展，protocol buffers 编译器：安装说明请参见 gRPC PHP 自述文件。
获取示例代码
示例代码是 grpc 代码库的一部分。
注意
您只能在 PHP 中创建 gRPC 客户端。请使用其他语言来创建 gRPC 服务器。克隆 grpc 仓库及其子模块
git clone --recurse-submodules -b v1.78.1 --depth 1 --shallow-submodules https://github.com/grpc/grpc切换到快速入门示例目录
cd grpc/examples/php安装
grpccomposer 包./greeter_proto_gen.sh composer install
运行示例
启动快速入门服务器：例如，请遵循 Node 快速入门中给出的说明。
在
examples/php目录下，运行 PHP 客户端./run_greeter_client.sh
恭喜！您刚刚运行了一个使用 gRPC 的客户端-服务器应用程序。
更新 gRPC 服务
现在，让我们看看如何通过在服务器上增加一个供客户端调用的方法来更新应用程序。我们的 gRPC 服务是使用 protocol buffers 定义的；您可以在基础教程中了解更多关于如何在 .proto 文件中定义服务的信息。目前，您只需要知道服务器和客户端“存根（stub）”都有一个 SayHello RPC 方法，该方法接收来自客户端的 HelloRequest 参数并返回来自服务器的 HelloResponse，并且该方法定义如下：
// The greeting service definition.
service Greeter {
// Sends a greeting
rpc SayHello (HelloRequest) returns (HelloReply) {}
}
// The request message containing the user's name.
message HelloRequest {
string name = 1;
}
// The response message containing the greetings
message HelloReply {
string message = 1;
}
让我们更新它，使 Greeter 服务有两个方法。编辑 examples/protos/helloworld.proto 并使用一个新的 SayHelloAgain 方法进行更新，该方法具有相同的请求和响应类型
// The greeting service definition.
service Greeter {
// Sends a greeting
rpc SayHello (HelloRequest) returns (HelloReply) {}
// Sends another greeting
rpc SayHelloAgain (HelloRequest) returns (HelloReply) {}
}
// The request message containing the user's name.
message HelloRequest {
string name = 1;
}
// The response message containing the greetings
message HelloReply {
string message = 1;
}
记得保存文件！
重新生成 gRPC 代码
接下来，我们需要更新应用程序使用的 gRPC 代码以使用新的服务定义。在 grpc 根目录下
protoc --proto_path=examples/protos \
--php_out=examples/php \
--grpc_out=examples/php \
--plugin=protoc-gen-grpc=bins/opt/grpc_php_plugin \
./examples/protos/helloworld.proto
或者，如果您从源码构建了 grpc-php-plugin，则运行 grpc/example/php 目录下的辅助脚本
./greeter_proto_gen.sh
这将重新生成 protobuf 文件，其中包含我们生成的客户端类，以及用于填充、序列化和检索请求与响应类型的类。
更新并运行应用程序
现在我们有了新生成的客户端代码，但我们仍然需要在示例应用程序的人工编写部分中实现并调用这个新方法。
更新服务器
在同一目录下，打开 greeter_server.js。按如下方式实现新方法
function sayHello(call, callback) {
callback(null, {message: 'Hello ' + call.request.name});
}
function sayHelloAgain(call, callback) {
callback(null, {message: 'Hello again, ' + call.request.name});
}
function main() {
var server = new grpc.Server();
server.addProtoService(hello_proto.Greeter.service,
{sayHello: sayHello, sayHelloAgain: sayHelloAgain});
server.bind('0.0.0.0:50051', grpc.ServerCredentials.createInsecure());
server.start();
}
...
更新客户端
在同一目录下，打开 greeter_client.php。按如下方式调用新方法
$request = new Helloworld\HelloRequest();
$request->setName($name);
list($reply, $status) = $client->SayHello($request)->wait();
$message = $reply->getMessage();
list($reply, $status) = $client->SayHelloAgain($request)->wait();
$message = $reply->getMessage();
运行！
就像我们之前做的那样，从 grpc-node/examples/helloworld/dynamic_codegen 目录
运行服务器
node greeter_server.js从另一个终端，在
examples/php目录下，运行客户端./run_greeter_client.sh