必须先装topthink/think-queue扩展才能启用队列命令，tp6/tp8需配置'default'=>'redis'并确保connections.redis键名一致，任务类须实现fire()或handle()方法且显式调用delete()，监听时需指定对应队列名如--queue=mail。
在ThinkPHP项目中启用队列功能时，发现TP5.1的队列驱动无法直接迁移到TP6或TP8，任务卡死、连接超时、消费失败频发，必须按新版本规范重写配置与消费逻辑才能让异步任务稳定运行。
确认当前框架版本与队列支持能力
执行 php think version 查看输出结果：若显示 ThinkPHP v5.1.x，则队列仅支持原生file、sync、redis（需手动安装topthink/think-queue扩展）；若为 v6.0+，队列已内建，无需额外扩展包；v8.0 要求 PHP 8.0+ 且默认使用think-queue v4.0+，Redis连接必须启用redis://协议而非tcp://。
TP5.1未内置队列，强行复用TP6配置会导致Driver not supported错误；TP6起取消think-queue独立包依赖，改由thinkphp/framework直接提供think\queue\connector\*类。
TP5.1升级到TP6队列配置迁移
第一步：删除旧版队列扩展
运行 composer remove topthink/think-queue，否则TP6启动时会因类名冲突报Class 'think\queue\Queue' not found。
第二步：更新队列配置文件
将config/queue.php中'default' => 'redis'改为'default' => 'redis'（保持不变），但必须把'redis' => [ 'host' => '127.0.0.1', 'port' => 6379 ]升级为'redis' => [ 'host' => 'redis://127.0.0.1:6379', 'password' => '', 'select' => 0 ]——【TP6强制要求使用redis://前缀，否则连接被拒绝】。
第三步：重写任务类命名空间
原TP5.1任务类app\job\SendEmail需改为app\queue\job\SendEmail，并在类首行添加use think\queue\Job;；构造函数参数必须为Job $job, $data，不可省略$job实例——否则$job->delete()调用失败，任务重复执行。
TP6启用Redis队列的实操步骤
方法一：命令行快速启动
执行 php think queue:listen --queue=mail --delay=0 --memory=128 --tries=3，监听mail队列，内存上限128MB，失败重试3次。该命令会阻塞当前终端，适合开发调试。
方法二：守护进程部署（Linux）
创建/etc/supervisor/conf.d/think-queue.conf，内容填入：
[program:think-queue]
command=/usr/bin/php /var/www/tp8/php think queue:work --queue=mail --delay=3 --sleep=3 --max-jobs=0 --daemon
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/var/log/think-queue.log
保存后运行 supervisorctl reread && supervisorctl update && supervisorctl start think-queue，队列服务即后台常驻运行。
方法三：Docker容器化部署
在docker-compose.yml中增加queue-worker服务，镜像基于php:8.1-apache，挂载项目代码，并在entrypoint中执行php think queue:work redis --queue=default——注意--queue值必须与config/queue.php中定义的队列名一致，否则消费端收不到任务。
TP8队列核心优势落地应用
① 支持协程消费（需Swoole扩展）
在config/queue.php中设置'worker' => 'swoole'，启动命令改为php think queue:work --worker=swoole，单进程并发处理能力提升3～5倍，CPU占用下降40%以上。
② 内置失败任务重试策略
投递任务时调用dispatch(new SendEmail($data))->delay(60)->afterCommit()，其中delay(60)表示60秒后执行，afterCommit()确保事务提交后再入队——【TP8默认关闭事务延迟投递，不加此方法可能导致数据未写入就发任务】。
③ 多通道隔离设计
配置'channels' => ['mail' => ['driver' => 'redis', 'queue' => 'mail'], 'sms' => ['driver' => 'redis', 'queue' => 'sms']]，不同业务类型走不同Redis列表，避免高优先级短信任务被低频邮件任务阻塞。
④ 实时监控集成
访问http://your-domain.com/admin/queue/status（需自行注册路由并调用think\queue\Monitor::getStats()），可查看各队列待处理数、失败数、运行时长，无需接入第三方监控平台。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
