最近需要用Laravel实现一个Rest的API,后端调用Golang的RPC服务,记录一下整合的过程。

环境准备

  1. php安装grpc和protobuf扩展

    pecl install grpc
    pecl install protobuf
    

    找到php.ini文件,添加下面两行:

    extension=grpc.so
    extension=protobuf.so
    
  2. clone一个grpc的repo

    git clone https://github.com/grpc/grpc.git
    

    假设目录在/home/aaa/下面

  3. 安装protobuf

    apt install protobuf
    

准备proto文件

文件名:userrpc.proto,内容如下

syntax = "proto3";
package App.UserRpc;


service User{
  rpc UserLogin(LoginInfo) returns (UserInfo) {}
}

message LoginInfo{
  string loginname= 1;
  string password= 2;
}


message UserInfo{
 int32 code= 1;
  string err_msg= 2;
  string token= 3;
  int32 userid= 4;
  string username= 5;
}

其中定义了两种消息结构和一个rpc服务。

生成PHP的gRPC客户端代码

  1. 在user.proto文件的所在目录,执行下面的命令:

    protoc --php_out=./ --grpc_out=./ --plugin=protoc-gen-grpc=/home/aaa/grpc/bins/opt/grpc_php_plugin user.proto
    

    如果没问题的话,应该会生成两个目录:App和GPBMetadata

  2. 拷贝文件

把App下面的UserRpc目录拷贝到laravel的app/下,把GPBMetadata目录拷贝到和app同级的目录。

  1. 设置composer

打开laravel的composer.json文件,在classmap下添加一行:

GPBMetadata

执行下面的命令:

composer require "grpc/grpc"

然后执行:

composer dump-autoload

编写Controller

现在可以去写一个laravel的controller试试了。

  public function login(Request $request){
    $loginname = $request->input("loginname");
    $password = (string)$request->input("password");
    $userrpc = new \App\UserRpc\UserClient("127.0.0.1:50052",[
                                'credentials' => \Grpc\ChannelCredentials::createInsecure()
                ]);
    $request = new \App\UserRpc\LoginInfo();
    $request->setLoginname($loginname);
    $request->setPassword($password);
    list($recv,$status) = $userrpc->UserLogin($request)->wait();
    $code = $recv->getCode();
    echo $code;
    exit;
  }