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¶ms=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¶ms=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[进程命令或者进程名称]