buexplain/netsvr-business-coroutine

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

v3.0.0 2024-11-10 11:57 UTC

Requires

• php: >=8.1
• buexplain/netsvr-protocol-php: ^4.0.0
• psr/container: ^2.0
• psr/log: ^2.0|^3.0

Requires (Dev)

• google/protobuf: ~3.22
• hyperf/command: ~3.1
• hyperf/config: ~3.1
• hyperf/event: ~3.1
• hyperf/framework: ~3.1
• hyperf/process: ~3.1
• hyperf/server: ~3.1
• hyperf/signal: ~3.1
• illuminate/container: ^10.0
• phpunit/phpunit: ^10.0
• phrity/websocket: ^v3.0
• swoole/ide-helper: *
• swow/swow: ^v1.5.3

Apache-2.0

• buexplain

• php
• websocket
• coroutine
• swoole
• hyperf
• swow
• netsvr

README

这是一个基于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会自行处理。