Skip to content

Latest commit

 

History

History
38 lines (27 loc) · 2.38 KB

README.md

File metadata and controls

38 lines (27 loc) · 2.38 KB

netsvr-business-coroutine

这是一个基于hyperf框架开发的,可以快速开发websocket全双工通信业务的包,它基于https://github.com/buexplain/netsvr 进行工作。

ps:如果你的项目是非协程的,串行执行php代码的,则可以使用这个包:https://github.com/buexplain/netsvr-business-serial

使用步骤

  1. 下载并启动网关服务:https://github.com/buexplain/netsvr/releases ,该服务会启动:websocket服务器、worker服务器
  2. 在hyperf项目里面安装本包以及protobuf包:
    • composer require buexplain/netsvr-business-coroutine
    • composer require google/protobuf
  3. 发布配置文件:php bin/hyperf.php vendor:publish buexplain/netsvr-business-coroutine
  4. 修改配置文件config/autoload/netsvr.php,把里面的workerAddr 配置项,改为网关服务的worker服务器地址,另外在app/Event.php 处理网关转发的事件,添加你的业务逻辑。
  5. 执行启动命令:php bin/hyperf.php start
  6. 搜索一个在线测试websocket的网页,连接到网关服务的websocket服务器,发送消息:你好,可以看到消息回显

本包的三种使用方式

如果你的项目需要接收网关主动发过来的消息,则你可以采用以下两种方式:

  1. 直接启动,执行启动命令:php bin/hyperf.php business:start ,另外要注意:此方式只运行在swoole驱动的hyperf下执行,且在cygwin版本swoole-cli下,无法使用hyperf框架的Db、redis组件。
  2. 跟随http服务器启动,配置文件listeners.php添加配置\NetsvrBusiness\Listener\StartMainSocketListener::class

如果你的项目不需要接收网关主动发过来的消息

你不需要做任何启动动作,直接使用\NetsvrBusiness\NetBus提供的静态方法与网关交互,此方式只能实现服务器主动下发数据到客户端,客户端无法发送消息给你的进程。

进程停止时候优雅断开与网关的连接

  • 如果你的项目安装了composer require hyperf/signal包,则配置文件signal.php 必须添加配置\NetsvrBusiness\Handler\StopHandler::class=>1
  • 没有安装,则不必做任何配置,本包的\NetsvrBusiness\Listener\CloseListener::class会自行处理。