PHP GRPC的试水

先说环境

• MacOS 10.16
• brew
• php 7.4+

前言

研究微服务治理，苦于找不到相对于php合适的rpc框架。多个服务起来，用curl或者guzzle相互域名请求简直太逆天奇葩了。由于服务大部分都是php的，没有常驻后台的daemon开发送心跳。因此对于rpc的选型也是个很严肃的问题。
看过yar、dubbo等协议，但是不是特别理想。yar本身是php的扩展。但是不支持服务治理，或者说只是一个远程过程调用的工具。dubbo主力支持java，其他语言虽然支持，但本质对于php来说和curl没大区别。今儿记录一下php+grpc的过程

安装

官方文档：https://grpc.io/docs/languages/php/quickstart/
本身就支持php的服务端和客户端，按文档操作如下：
安装扩展：

$ pecl install protobuf
$ pecl install grpc

上面 protobuf 是 grpc 通信所使用的协议。类似thrift，一个跨语言的结构定义工具？（瞎起）

安装好后，按照文档，装个php-protoc插件，用来生成php相关的class和service

$ git clone -b v1.33.2 https://github.com/grpc/grpc
$ cd grpc
$ git submodule update --init
$ make grpc_php_plugin

第一次安装一直在报

Can't exec "aclocal": No such file or directory at /usr/local/Cellar/autoconf/2.69/share/autoconf/Autom4te/FileUtils.pm line 326.

然后发现是因为automake没装。好吧。

$ brew install automake
$ brew install protobuf #这个我偶然装的 不知道不装对后续会不会有影响

重新执行上述命令，编译安装完了。

First Example

继续按照文档，执行代码库里的submoudle:

$ cd examples/php
$ ./greeter_proto_gen.sh

如此应该是把预定义好的这个生成了php的文件，目录结构如下

i@wdeMacBook-Pro:~/Code/grpc-try/grpc/examples/php|ee5b762f33⚡ ⇒  ll
total 40
drwxr-xr-x   3 i  staff    96B 11 16 11:11 GPBMetadata
drwxr-xr-x   5 i  staff   160B 11 16 11:11 Helloworld
-rw-r--r--   1 i  staff   1.0K 11 16 10:42 README.md
-rw-r--r--   1 i  staff   348B 11 16 10:42 composer.json
drwxr-xr-x  11 i  staff   352B 11 16 10:42 echo
-rw-r--r--   1 i  staff   1.5K 11 16 10:42 greeter_client.php
-rwxr-xr-x   1 i  staff   728B 11 16 10:42 greeter_proto_gen.sh
drwxr-xr-x   6 i  staff   192B 11 16 10:42 route_guide
-rwxr-xr-x   1 i  staff   691B 11 16 10:42 run_greeter_client.sh

接着执行composer install 安装相关依赖。

$ cd ../node

教程中用node起了一个服务端。

$ npm install 

第一次安装报错，好吧。再装一次，提示我Error: The gRPC binary module was not installed. This may be fixed by running "npm rebuild"
我tm。。
经过各种npm install，算是装完了。然后

$ cd dynamic_codegen
$ node greeter_server.js

目测已经起来了，没有任何提示
再开一个窗口，执行

$ ./run_greeter_client.sh
PHP Warning:  PHP Startup: Unable to load dynamic library 'grpc.so' (tried: /usr/local/lib/php/pecl/20190902/grpc.so (dlopen(/usr/local/lib/php/pecl/20190902/grpc.so, 9): image not found), /usr/local/lib/php/pecl/20190902/grpc.so.so (dlopen(/usr/local/lib/php/pecl/20190902/grpc.so.so, 9): image not found)) in Unknown on line 0

Warning: PHP Startup: Unable to load dynamic library 'grpc.so' (tried: /usr/local/lib/php/pecl/20190902/grpc.so (dlopen(/usr/local/lib/php/pecl/20190902/grpc.so, 9): image not found), /usr/local/lib/php/pecl/20190902/grpc.so.so (dlopen(/usr/local/lib/php/pecl/20190902/grpc.so.so, 9): image not found)) in Unknown on line 0
PHP Fatal error:  Uncaught Error: Class 'Grpc\ChannelCredentials' not found in /Users/i/Code/grpc-try/grpc/examples/php/greeter_client.php:30
Stack trace:
#0 /Users/i/Code/grpc-try/grpc/examples/php/greeter_client.php(44): greet('localhost:50051', 'world')
#1 {main}
  thrown in /Users/i/Code/grpc-try/grpc/examples/php/greeter_client.php on line 30

Fatal error: Uncaught Error: Class 'Grpc\ChannelCredentials' not found in /Users/i/Code/grpc-try/grpc/examples/php/greeter_client.php:30
Stack trace:
#0 /Users/i/Code/grpc-try/grpc/examples/php/greeter_client.php(44): greet('localhost:50051', 'world')
#1 {main}
  thrown in /Users/i/Code/grpc-try/grpc/examples/php/greeter_client.php on line 30

。。。官网说的congratulation 给谁听呢。。
php -m果然没看见我的grpc。。再装一遍看看
…漫长的编译之旅
这回看见了 难道我刚才装了个寂寞
这回执行

$ ./run_greeter_client.sh
PHP Warning:  Module 'grpc' already loaded in Unknown on line 0

Warning: Module 'grpc' already loaded in Unknown on line 0
Hello world

OK，这是看见了服务端的返回了。（btw，安装的时候自己在php.ini里加了extension，然后还说重复了。我再删了就好了。原因是脚本中执行的语句，自己看。）

看一看代码

vscode打开php目录，HelloWorld和GPBMetadata都是由protobuf生成的。proto文件在上层目录的protos下，长如下这样：

// Copyright 2015 gRPC authors.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
//     http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.

syntax = "proto3";

option java_multiple_files = true;
option java_package = "io.grpc.examples.helloworld";
option java_outer_classname = "HelloWorldProto";
option objc_class_prefix = "HLW";

package helloworld;

// 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;
}

定义了package名helloworld，service对应php的命名空间，message对应的是结构体。对应php的HelloWorld目录下的东西。可以用composer加载，也可以用require_once加载。
看下函数

<?php

require dirname(__FILE__).'/vendor/autoload.php';

function greet($hostname, $name)
{
    $client = new Helloworld\GreeterClient($hostname, [
        'credentials' => Grpc\ChannelCredentials::createInsecure(),
    ]);
    $request = new Helloworld\HelloRequest();
    $request->setName($name);
    list($response, $status) = $client->SayHello($request)->wait();
    if ($status->code !== Grpc\STATUS_OK) {
        echo "ERROR: " . $status->code . ", " . $status->details . PHP_EOL;
        exit(1);
    }
    echo $response->getMessage() . PHP_EOL;
}

$name = !empty($argv[1]) ? $argv[1] : 'world';
$hostname = !empty($argv[2]) ? $argv[2] : 'localhost:50051';
greet($hostname, $name);

直接通过protobuf定义的Client就可以实例化啦。对应的方法啥的都已经在里面了。没错，就是我们想要的亚子。

接下来需要考虑的还有服务端的架设，服务中心的架设。不说了，再研究研究。