1.先安装编译器:https://github.com/google/protobuf/releases把bin下的exe放到环境PATH目录。做成环境变量.
2.获取go支持库的插件:
// gRPC运行时接口编解码支持库
go get -u github.com/golang/protobuf/proto
// 从 Proto文件(gRPC接口描述文件) 生成 go文件 的编译器插件
go get -u github.com/golang/protobuf/protoc-gen-go
3.编写test.proto( protocol buffers 文件)
syntax = "proto3";
// 定义包名
package test;
// 可以定义多个服务,每个服务内可以定义多个接口
service Waiter {
// 定义接口 (结构体可以复用)
// 方法 (请求消息结构体) returns (返回消息结构体) {}
rpc DoMD5 (Req) returns (Res) {}
}
// 定义 Req 消息结构
message Req {
// 类型 字段 = 标识号
string jsonStr = 1;
}
// 定义 Res 消息结构
message Res {
string backJson = 1;
}
// PS:jsonStr和backJson只是随手写的名字,并没有用json
这里面其实就是声明相关服务和请求响应参数之类的相关规范.
4.然后就要用第一步安装的编译器来编译这个规范文件:
// protoc --go_out=plugins=grpc:{输出目录} {proto文件}
protoc --go_out=plugins=grpc:./test/ ./test.proto
会在test目录下生成一个test.pb.go文件.
现在我们在项目根目录下建一个a目录用来存放服务端文件server.go:
package main
import (
"log"
"net"
"golang.org/x/net/context"
"google.golang.org/grpc"
"gtest/test"
"google.golang.org/grpc/reflection"
"fmt"
"crypto/md5"
)
// 业务实现方法的容器
type server struct{}
// 为server定义 DoMD5 方法 内部处理请求并返回结果
// 参数 (context.Context[固定], *test.Req[相应接口定义的请求参数])
// 返回 (*test.Res[相应接口定义的返回参数,必须用指针], error)
func (s *server) DoMD5(ctx context.Context, in *test.Req) (*test.Res, error) {
fmt.Println("MD5方法请求JSON:"+in.JsonStr)
return &test.Res{BackJson: "MD5 :" + fmt.Sprintf("%x", md5.Sum([]byte(in.JsonStr)))}, nil
}
func main() {
lis, err := net.Listen("tcp", ":8028") //监听所有网卡8028端口的TCP连接
if err != nil {
log.Fatalf("监听失败: %v", err)
}
s := grpc.NewServer() //创建gRPC服务
/**注册接口服务
* 以定义proto时的service为单位注册,服务中可以有多个方法
* (proto编译时会为每个service生成Register***Server方法)
* 包.注册服务方法(gRpc服务实例,包含接口方法的结构体[指针])
*/
test.RegisterWaiterServer(s, &server{})
/**如果有可以注册多个接口服务,结构体要实现对应的接口方法
* user.RegisterLoginServer(s, &server{})
* minMovie.RegisterFbiServer(s, &server{})
*/
// 在gRPC服务器上注册反射服务
reflection.Register(s)
// 将监听交给gRPC服务处理
err = s.Serve(lis)
if err != nil {
log.Fatalf("failed to serve: %v", err)
}
}
然后在根目录下建一个b目录来存放客户端文件client.go:
package main
import (
"log"
"os"
"golang.org/x/net/context"
"google.golang.org/grpc"
"gtest/test"
)
func main() {
// 建立连接到gRPC服务
conn, err := grpc.Dial("127.0.0.1:8028", grpc.WithInsecure())
if err != nil {
log.Fatalf("did not connect: %v", err)
}
// 函数结束时关闭连接
defer conn.Close()
// 创建Waiter服务的客户端
t := test.NewWaiterClient(conn)
// 模拟请求数据
res := "test123"
// os.Args[1] 为用户执行输入的参数 如:go run ***.go 123
if len(os.Args) > 1 {
res = os.Args[1]
}
// 调用gRPC接口
tr, err := t.DoMD5(context.Background(), &test.Req{JsonStr: res})
if err != nil {
log.Fatalf("could not greet: %v", err)
}
log.Printf("服务端响应: %s", tr.BackJson)
}
我们看到,无论是服务端和客户端,都要用到之前用编译器编译生成的test包。
现在文件夹结构如下:
根目录下运行go mod init gtest
然后运行服务端文件go run ./a/server.go
然后运行客户端文件go run ./b/client.go
打印:2020/07/05 14:01:34 服务端响应: MD5 :cc03e747a6afbbcbf8be7668acfebee5
上面我们分别完成了go之前的grpc调用.现在我们来编写php的客户端.
新建目录gtest2.把之前建的proto文件拷过来。然后执行如下命令编译:
protoc --php_out=. test.proto
会编译生成Res.php和Req.php文件,看名思义.
然后编写composer.json
{
"name": "grpc-go-php",
"require": {
"grpc/grpc": "^v1.3.0",
"google/protobuf": "^v3.3.0"
},
"autoload":{
"psr-4":{
"GPBMetadata\\":"GPBMetadata/",
"Test\\":"Test/"
}
}
}
composer install
在Test目录下建立客户端文件Client.php
<?php
namespace Test;
/**
* service Xuexitest{}
* 编写 (gprc 定义 Xuexitest 服务)的客户端
*/
class Client extends \Grpc\BaseStub{
public function __construct($hostname, $opts, $channel = null) {
parent::__construct($hostname, $opts, $channel);
}
/**
* rpc SayTest(TestRequest) returns (TestReply) {}
* 方法名尽量和 (gprc 定义 Xuexitest 服务)的方法一样
* 用于请求和响应该服务
*/
public function SayTest(\Test\Req $argument,$metadata=[],$options=[]){
// (/xuexitest.Xuexitest/SayTest) 是请求服务端那个服务和方法,基本和 proto 文件定义一样
// (\Xuexitest\TestReply) 是响应信息(那个类),基本和 proto 文件定义一样
return $this->_simpleRequest('/test.Waiter/DoMD5',
$argument,
['\Test\Req', 'decode'],
$metadata, $options);
}
}
然后在根目录下创建test.php文件进行验证:
<?php
//引入 composer 的自动载加
require __DIR__ . '/vendor/autoload.php';
//用于连接 服务端
$client = new \Test\Client('127.0.0.1:8028', [
'credentials' => \Grpc\ChannelCredentials::createInsecure()
]);
//实例化 TestRequest 请求类
$request = new \Test\Req();
$request->setJsonStr("test123");
//调用远程服务
$get = $client->SayTest($request)->wait();
//返回数组
//$reply 是 TestReply 对象
//$status 是数组
list($reply, $status) = $get;
//数组
var_dump($reply->getJsonStr());
参考链接: