ThinkPHP项目需引入异步任务机制以解决短信发送、APP推送等耗时操作导致的响应延迟与稳定性差问题，可选用Redis、Database、Sync、Topthink云队列或Swoole五种think-queue集成方案。
如果您在ThinkPHP项目中需要处理短信发送、APP推送等耗时操作，但当前仍采用同步执行方式导致响应延迟、系统稳定性差，则说明亟需引入异步任务机制。以下是集成think-queue消息队列的多种可行方案：
一、通过Composer安装并配置Redis驱动
Redis驱动具备高性能、低延迟特性，适合高并发场景下的任务分发与消费。该方案依赖Redis服务已启动且PHP已启用redis扩展。
1、在项目根目录执行命令安装think-queue扩展：composer require topthink/think-queue
2、确认项目config目录下生成queue.php配置文件；若未自动生成，手动创建该文件并写入以下内容：
立即学习“PHP免费学习笔记（深入）”；
3、编辑config/queue.php，将default设为'redis'，并在connections.redis中填入实际Redis连接参数：'host' => '127.0.0.1', 'port' => 6379, 'password' => '', 'select' => 0
4、确保Redis服务正在运行，且PHP已加载redis扩展（可通过php -m | grep redis验证）。
二、使用Database驱动实现零外部依赖部署
Database驱动以数据表为消息存储介质，无需额外安装中间件，适用于开发环境或资源受限的轻量级部署。
1、执行数据库迁移命令创建jobs表：php think migrate:run
2、在config/queue.php中将default设为'database'，并在connections.database中指定表名与连接配置：'table' => 'jobs', 'queue' => 'default'
3、确保数据库连接正常，并在.env中配置好DB_HOST、DB_NAME等基础参数。
4、运行php think queue:listen database监听该驱动队列。
三、启用Sync驱动快速验证业务逻辑
Sync驱动不依赖任何外部服务，所有任务在当前请求周期内立即同步执行，用于开发调试阶段快速验证任务类是否定义正确、fire方法能否正常运行。
1、在config/queue.php中将default设为'sync'：'default' => 'sync'
2、保持connections.sync.type为'sync'，其余字段可省略。
3、调用Queue::push()后任务会即时触发fire方法，便于var_dump或Log::info调试输出。
4、注意：此模式不具备异步性，不可用于生产环境。
四、集成Topthink云队列服务实现免运维托管
Topthink驱动对接官方消息通知服务平台，由服务端统一管理任务分发、重试、监控与失败告警，开发者无需维护消费者进程。
1、在config/queue.php中将connector设为'Topthink'：'connector' => 'Topthink'
2、填写平台分配的token与project_id：'token' => 'your_token_here', 'project_id' => 'your_project_id'
3、启用HTTPS协议并确认host为qns.topthink.com，端口为443。
4、调用Queue::push()后任务自动上传至云端，由平台调度执行并回调结果。
五、基于Swoole常驻内存模式启动队列消费者
利用think-swoole扩展启动长生命周期的队列监听进程，避免传统CLI模式下频繁启停带来的性能损耗与状态丢失问题。
1、安装think-swoole扩展：composer require topthink/think-swoole
2、在app/config/swoole.php中启用queue监听器配置项：'queue' => ['enable' => true]
3、定义任务类时继承think\swoole\queue\Job，并实现handle方法而非fire方法。
4、启动Swoole服务：php think swoole:start，队列消费者将随服务一同启动并持续运行。
