# MuuCmf 消息队列与计划任务使用文档 # 概述 本文档介绍 MuuCmf 内置消息队列、计划任务(crontab)的启动命令、运行方式与部署建议,推荐搭配 Supervisor 进程管理器进行常驻守护,适用于测试环境与生产环境部署。 **执行根目录统一为:**`/www/wwwroot/站点目录/`,所有命令需要在该目录下执行。 # 消息队列 消息队列用于异步处理任务,例如消息推送、订单处理、文件处理、通知发送等耗时任务,避免阻塞主业务请求。 ## 运行命令 ### 测试环境(调试使用) ```bash php think queue:listen --timeout 0 --memory 1024 ``` **参数说明:** - `queue:listen`:监听模式,文件改动会自动重启进程,适合开发调试。 - `--timeout 0`:任务不设置超时时间。 - `--memory 1024`:进程最大内存限制 1024M。 不建议生产环境使用 listen 模式,该模式性能较差,会频繁重启进程。 ### 生产环境(正式业务) ```bash php think queue:work ``` - `queue:work`:工作模式,性能更高,常驻处理队列任务;代码修改不会自动重启,更新代码后需要手动重启进程。 ## 推荐部署方式:Supervisor 守护进程 生产环境强烈建议使用 Supervisor 托管队列进程,实现进程异常自动重启、开机自启。 1. 安装 Supervisor。 2. 新增配置文件,示例配置如下: ```ini [program:muucmf-queue] command=php think queue:work directory=/www/wwwroot/站点目录/ user=www autostart=true autorestart=true stdout_logfile=/www/wwwroot/站点目录/runtime/log/queue.log redirect_stderr=true ``` 3. 加载配置并启动: ```bash supervisorctl reread supervisorctl update supervisorctl start muucmf-queue ``` # 计划任务(Crontab) MuuCmf 内置计划任务服务,用于定时执行后台任务,例如定时统计、自动结算、定时同步数据等。 ## 启动命令 ```bash php think crontab start ``` 同样在站点根目录 `/www/wwwroot/站点目录/` 下执行。 ## 推荐部署方式:Supervisor 守护进程 计划任务进程需要常驻运行,推荐 Supervisor 托管: ```ini [program:muucmf-crontab] command=php think crontab start directory=/www/wwwroot/站点目录/ user=www autostart=true autorestart=true stdout_logfile=/www/wwwroot/站点目录/runtime/log/crontab.log redirect_stderr=true ``` 加载并启动: ```bash supervisorctl reread supervisorctl update supervisorctl start muucmf-crontab ``` # 常用管理命令(Supervisor) ```bash # 查看所有进程状态 supervisorctl status # 重启队列 supervisorctl restart muucmf-queue # 重启计划任务 supervisorctl restart muucmf-crontab # 停止进程 supervisorctl stop muucmf-queue supervisorctl stop muucmf-crontab ``` # 注意事项 1. 所有命令必须进入网站根目录执行,否则会报命令不存在。 2. 代码更新后,需要手动重启 Supervisor 对应的进程,新代码才会生效。 3. 注意运行用户权限,`www` 用户需要拥有站点目录读写权限。 4. 查看日志:可以通过配置的 log 文件排查任务报错、异常。 5. 不要同时启动多个相同队列/计划任务进程,避免重复执行任务。 6. 服务器防火墙、安全软件不要拦截 PHP 进程。 # 命令速查 |类型|命令|适用场景| |---|---|---| |消息队列 listen|`php think queue:listen --timeout 0 --memory 1024`|测试、开发调试| |消息队列 work|`php think queue:work`|正式生产环境| |计划任务|`php think crontab start`|定时任务常驻服务|