代码拉取完成，页面将自动刷新
在 imi 框架中集成 gRPC 服务开发、客户端调用及连接池。
通讯协议为二进制的 Protobuf。
本项目可以使用composer安装，遵循psr-4自动加载规则，在你的 composer.json 中加入下面的内容:
{
"require": {
"imiphp/imi-grpc": "^1.0.0"
}
}
然后执行 composer update 安装。
可以参考 example 目录示例，包括完整的服务端和客户端调用。
gRPC 和 Protobuf 是黄金搭档，Protobuf 是用来做通讯消息格式的序列化和反序列化的工作。
gRPC 通讯有请求（Request）消息和响应（Response）消息，从请求消息中获取请求参数，通过响应消息返回给客户端。
定义参考：example/grpc/grpc.proto
syntax = "proto3";
package grpc;
option php_generic_services = true;
service AuthService {
rpc Login (LoginRequest) returns (LoginResponse);
}
message LoginRequest {
string phone = 1; // 手机号
string password = 2; // 密码
}
message LoginResponse {
bool success = 1; // 是否成功
string error = 2; // 错误信息
}
定义好后，通过命令生成 PHP 文件：protoc --php_out=./ grpc.proto
protoc 下载和安装：https://github.com/protocolbuffers/protobuf/releases
在项目 config/config.php 中配置：
[
'components' => [
// 引入RPC组件以及本组件
'Rpc' => 'Imi\Rpc',
'Grpc' => 'Imi\Grpc',
],
]
如果你用主服务器：
[
// 主服务器配置
'mainServer' => [
'namespace' => 'ImiApp\GrpcServer',
'type' => 'Grpc',
'host' => '127.0.0.1',
'port' => 8080,
],
]
如果你用子服务器：
[
// 子服务器（端口监听）配置
'subServers' => [
// 子服务器名
'XXX' => [
'namespace' => 'ImiApp\GrpcServer',
'type' => 'Grpc',
'host' => '127.0.0.1',
'port' => 8080,
]
],
]
写法与 Http Api 几乎一致。
标准 gRPC Url 格式为：http://host:port/{package}.{service}/{method}
/**
* @Controller("/grpc.AuthService/")
*/
class AuthServiceController extends HttpController implements AuthServiceInterface
{
/**
* Method <code>login</code>
*
* @Action
*
* @param \Grpc\LoginRequest $request
* @return \Grpc\LoginResponse
*/
public function login(\Grpc\LoginRequest $request)
{
$response = new LoginResponse;
$success = '12345678901' === $request->getPhone() && '123456' === $request->getPassword();
$response->setSuccess($success);
$response->setError($success ? '' : '登录失败');
return $response;
}
}
[
// 连接池配置
'pools' => [
'grpc' => [
'async' => [
'pool' => [
'class' => \Imi\Rpc\Client\Pool\RpcClientCoroutinePool::class,
'config' => [
// 根据实际情况设置
'maxResources' => 100,
'minResources' => 1,
],
],
'resource' => [
// 这里需要和你的服务端路由一致
'url' => 'http://127.0.0.1:8080/{package}.{service}/{name}',
// 'url' => 'http://127.0.0.1:8080/{package}.{service}/{name|ucfirst}', // 参数支持设定函数处理，比如这个将方法名首字母大写，兼容其它部分语言
'clientClass' => \Imi\Grpc\Client\GrpcClient::class,
'method' => 'POST', // 指定请求方式，默认 GET
'timeout' => 30, // 超时时间，单位：秒
]
],
],
],
'rpc' => [
'defaultPool' => 'grpc',
],
]
代码调用：
// $service = \Imi\Rpc\Client\Pool\RpcClientPool::getClient('连接池名')->getService('服务名', '生成出来的服务接口类名');
$service = \Imi\Rpc\Client\Pool\RpcClientPool::getClient()->getService('AuthService', \Grpc\AuthServiceInterface::class);
$request = new \Grpc\LoginRequest;
$request->setPhone('');
$service->login($request);
注解调用：
use Imi\Rpc\Annotation\RpcClient;
use Imi\Grpc\Client\Annotation\GrpcService;
class Test
{
/**
* @RpcClient()
*
* @var \Imi\Rpc\Client\IRpcClient
*/
protected $rpcClient;
/**
* @GrpcService(serviceName="grpc.AuthService", interface=\Grpc\AuthServiceInterface::class)
*
* @var \Grpc\AuthServiceInterface
*/
protected $authService;
public function aaa()
{
$request = new \Grpc\LoginRequest;
$request->setPhone('');
// 方法一
$this->rpcClient->getService('服务名', '生成出来的服务接口类名')->方法名($request);
// 方法二
$this->xxxRpc->方法名($request);
}
}
@GrpcService 注解的 serviceName 属性格式为 {package}.{service}；
interface 属性是生成出来的服务接口类名
↓↓↓注意↓↓↓：
使用
@GrpcService注解注入时，如果调用的grpc接口方法名是：getName、send、recv、call、getClient，请使用call方法来调用，因为这和内置方法名相冲突了。
QQ群：17916227 
，如有问题会有人解答和修复。
imi-grpc 遵循 MIT 开源协议发布，并提供免费使用。
开源不求盈利，多少都是心意，生活不易，随缘随缘……
此处可能存在不合适展示的内容，页面不予展示。您可通过相关编辑功能自查并修改。
如您确认内容无涉及 不当用语 / 纯广告导流 / 暴力 / 低俗色情 / 侵权 / 盗版 / 虚假 / 无价值内容或违法国家有关法律法规的内容，可点击提交进行申诉，我们将尽快为您处理。
1. 开源生态
2. 协作、人、软件
3. 评估模型