Swoole-Task:简单高效的异步任务处理框架

933 查看

Swoole-Task

github 地址:https://github.com/luxixing/swoole-task
欢迎 star 提 issues

Swoole-Task 用法示例


  • 路由说明

127.0.0.1:9510/ctrl/action?paramas=xxx

ctrl对应app/ctrl目录下的xxxCtrl.php文件(xxxCtrl.php中的class名称也必须是xxxCtrl,继承base\Ctrl)

action对应xxxCtrl.php文件中的xxxAction(action 的最后必须返回$this->ret,即最后一句 return $this->ret)

127.0.0.1:9510?op=ctrl.action&params=xxx 等同于 127.0.0.1:9510/ctrl/action?paramas=xxx

  • 启动swoole-task后发起请求(假定监控的ip和端口是127.0.0.1:9510)

curl "127.0.0.1:9510/ctrl/action?paramas=xxx" 或者 curl "127.0.0.1:9510?op=ctrl.action&params=xxx"

投递任务到swoole-task进行处理

  • swoole-task目录结构说明

app swoole-task具体处理业务逻辑的地方

app\config 配置文件目录,根据环境dev,test,prod来加载配置,环境的配置在config/swoole.ini的配置项 env

app\ctrl controller文件所在目录,处理具体业务逻辑,继承base\Ctrl这个类

app\dao 数据访问层,操作数据库的方法

app\helper 公共方法类

app\vendor 如果依赖composer 第三方库,在在app目录下创建composer.json

base 核心框架类,Ctrl Dao Helper App 四个类,命名空间base

config swoole-task 配置文件目录swoole.ini,配置参数类容参考源码说明

tmp 临时目录,日志swoole-task中间文件等等在此目录下存放

swoole-task 本身是一个比较简单的基于swoole扩展的异步任务处理框架,更详细使用方法看源码,或者在github留issues,有好的建议我会根据情况及时改进

Swoole-Task服务管理脚本功能说明


1 如果swoole.php 脚本所在目录config/swoole.ini 文件不存在,可以直接删除config目录,会自动创建配置文件,创建后的文件根据需求修改

2 注意swoole.ini 的参数dev,这个取值为dev,test,prod 根据此值读取swoole/app的配置文件


用法介绍

  • 服务启动

#启动服务,不指定绑定端口和ip,则使用config目录下的swoole.ini配置
php swoole.php start 
#启动服务 指定ip 和 port
php swoole.php -h127.0.0.1 -p9510 start
#启动服务 守护进程模式
php swoole.php -h127.0.0.1 -p9510 -d start
#启动服务 非守护进程模式
php swoole.php -h127.0.0.1 -p9510 -D start
#启动服务 指定进程名称(显示进程名为 swooleServ-9510-[master|manager|event|task]
php swoole.php -h 127.0.0.1 -p 9510 -n 9510 start
  • 服务停止(停止服务最少要指定端口)

php swoole.php -p 9510 stop
php swoole.php -h 127.0.0.1 - p 9510 stop
  • 服务重启(至少指定端口)

php swoole.php -p 9510 restart
php swoole.php -h 127.0.0.1 - p 9510 restart
  • 服务状态(必须指定ip 和 端口)

php swoole.php -h 127.0.0.1 - p 9510 status
  • swoole-task所有启动实例进程列表(一台服务器swoole-task可以有多个端口绑定的实例)

php swoole.php list
参数说明

  • --help
    显示帮助

  • -d, --daemon
    指定此参数,服务以守护进程模式运行,不指定读取配置文件值

  • -D, --nondaemon
    指定此参数,以非守护进程模式运行,不指定则读取配置文件值

  • -h, --host
    指定监听ip,例如 php swoole.php -h 127.0.0.1

  • -p, --port
    指定监听端口port, 例如 php swoole.php -h 127.0.0.1 -p 9520

  • -n, --name
    指定服务进程名称,例如 php swoole.php -n test start, 则进程名称为SWOOLE_TASK_NAME_PRE-name

命令说明

  • start 启动服务

可指定服务绑定ip 端口 及 是否守护进程模式,还有启动后进程名称(进程名称前缀默认为swooleServ-, 指定后 swooleServ-name-[master|manager|event|task])

  • stop 停止服务

必须指定端口参数 -p(--port)

  • restart 重启服务

必须指定端口参数 -p(--port) 后续是否需要根据进程名称重启根据实际情况来看(--TODO)

  • status

查看指定ip和端口的服务状态,tasking_num是指当前正在运行的任务

  • list

查看当前服务器上运行的swoole-task实例,
返回结果显示服务进程的 USER PID RSS(kb)[使用内存] STAT[进程状态] START[进程运行开始时间] COMMAND[进程命令或者进程名称]