Laravel如何配置Horizon来管理队列？（安装和使用）

Horizon 是 Laravel 官方 Redis 队列监控工具，需安装扩展、发布配置与迁移、配置环境参数、用 Supervisor 守护进程，并启用 Web 控制台实现队列实时管理。

Horizon 是 Laravel 官方推出的队列监控和管理工具，专为 Redis 驱动的队列设计。它提供实时仪表盘、任务统计、失败重试控制、进程调度和负载自动伸缩等功能。配置 Horizon 的核心是安装、发布配置、启动服务三步，下面直接说清楚怎么配、怎么用。

安装 Horizon 扩展包

确保你的项目已使用 Redis 作为队列驱动（.env 中 QUEUE_CONNECTION=redis），然后执行：

• 运行命令安装：composer require laravel/horizon
• 发布配置和迁移：php artisan horizon:install（该命令会生成 config/horizon.php 并发布迁移）
• 运行迁移创建表：php artisan migrate（Horizon 会记录失败任务、监控数据等）

配置 Horizon 工作环境

编辑 config/horizon.php，重点关注以下几项：

• environments：按环境（如 local、production）定义队列进程数、内存限制、超时等。例如生产环境可设 'supervisor-1' => ['connection' => 'redis', 'queue' => ['default', 'emails'], 'processes' => 10]
• fast_termination：设为 true 可让 Horizon 在收到终止信号时快速关闭 worker，避免任务中断
• trim 设置保留多少天的失败任务与监控日志（默认 60 天，建议生产环境调低至 7–30）

配置后记得运行 php artisan config:clear 生效。

启动与守护 Horizon 进程

Horizon 本质是一个常驻的 Artisan 命令，需用进程管理器长期运行：

标签： php laravel redis 前端 composer app 工具 ai 开发环境 red