Download the PHP package mix/grpc without Composer
On this page you can find all versions of the php package mix/grpc. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package grpc
OpenMix 出品:https://openmix.org
Mix gRPC
PHP gRPC based on Swoole coroutine, including protoc code generator, server, and client
基于 Swoole 协程的 PHP gRPC 库,包含 protoc 代码生成器、服务器、客户端
Overview
由于 PHP-FPM 的特殊生命周期,导致 PHP 的 gRPC 官方代码生成器只能生成数据结构和客户端代码,无法像 golang/node.js/python 一样能同时生成服务器代码;传统方式如果要搭建 PHP gRPC 服务器只能借助 nginx+h2+phpfpm 来搭建,这样就不需要 server 代码了,但是短生命周期又无法很好的支持服务注册,因为这些原因导致 PHP 在 gRPC 中一直都是充当 Client 的角色,Mix gRPC 提供了基于 Swoole 的方案:
- 使用 Swoole 作为 gRPC Server
- 使用 Golang 打造的 protoc-gen-mix 来生成 service 的 server/client 代码
- 完全独立,可在任何 CLI 模式的 php 代码中执行,任何框架的 CLI 模式中执行 Laravel、ThinkPHP、MixPHP 等都可以
- 同时为了降低门槛,我已经将 protoc、protoc-gen-mix 文件编译好了 win、linux、macOS 三个系统的二进制文件,直接下载即可
让 PHP 编写 gRPC 和 Golang 一样方便快捷,同时性能强劲
推荐搭配以下数据库使用 (支持协程和连接池):
技术交流
知乎:https://www.zhihu.com/people/onanying
官方QQ群:284806582
, 825122875
敲门暗号:grpc
Installation
- Swoole >= 4.4.4: https://wiki.swoole.com/#/environment
- 需要开启
--enable-http2
下载 protoc 与相关 plugin
- protoc 是 protobuf 数据结构代码生成器,负责将 .proto 数据结构文件生成为对应语言的 class、struct 供程序使用,
- protoc-gen-mix 是 mix 开发的 protoc 插件,用来生成 service 的 server/client 代码。
以上 2 个二进制文件,我都帮你们编译好了,包含多个常用 OS 类型,直接下载即可:
- 下载 protoc_mix_plugin
win/macos/linux
下载完成后 linux、macOS 将二进制文件放入系统 /usr/local/bin
目录,win 放入 C:\WINDOWS\system32
通过 .proto 生成 PHP 代码
首先我们编写一个 proto 文件:
然后使用 protoc 生成代码:
执行命令后将在当前目录生成以下文件:
其中 Request.php、Response.php 为 --php_out
生成,SayClient.php SayInterface.php 由 --mix_out
生成。
接下来我们将生成的文件加入到 composer autoload 中,我们修改 composer.json:
修改后执行 composer dump-autoload
使其生效。
编写一个 gRPC 服务
我们用原生 PHP 代码来编写一个 gRPC 服务器:
Swoole 多进程 (异步) 中使用
开启多进程协程
Swoole 单进程 (协程) 中使用
客户端调用一个 gRPC 服务
通过 IP 端口调用 gRPC 服务,复用客户端时请注意:协程环境中,不可在并发请求中使用单例
设置 header
设置 timeout
FPM 如何调用 gRPC 服务
像我们传统 PHP FPM 模式中,我们作为客户端调用 gRPC 比 Mix gRPC 提供的客户端要复杂很多,但是我们也经常需要用到,比如在 thinkphp laravel 中调用 Mix gRPC 或者 Mix Go 编写的 gRPC 服务,推荐阅读以下文章:
网上的文章都缺少重要的一环,就是:
命令执行时,只会生成数据结构的 class 文件,不会生成 grpc 服务的客户端 class 文件
以上服务没有被处理,没有生成出 SayClient.php
,需要修改编译命令
命令中指定了一个 grpc_php_plugin
文件是由 grpc/grpc 提供的源码,官方没有像 protoc
一样提供编译好的二进制可以下载,只能自己编译。然而这个库依赖的大量的子仓库,在国内几乎无法拉取成功,其次 win 的 cmake 编译很多人不会弄,导致大量的人无法编译出这个文件,因此我这里直接提供编译好的二进制供大家下载。
- 下载 protoc_grpc_plugin
win/macos/linux
License
Apache License Version 2.0, http://www.apache.org/licenses/