Laravel Horizon是一款官方Redis队列监控工具，提供美观仪表盘展示任务状态、处理速度及失败任务；通过composer require laravel/horizon安装，执行php artisan horizon:install发布资源文件，配置.env中QUEUE_CONNECTION=redis并确保Redis连接正确；在config/horizon.php中设置不同环境的进程数与队列策略；通过修改HorizonServiceProvider控制访问权限，启动php artisan horizon服务后访问/horizon路径即可查看监控面板，包含活跃队列、处理速率、失败任务等信息，适用于中大型项目提升队列管理效率。

Laravel Horizon 是 Laravel 官方推出的 Redis 队列监控和管理工具，它提供了一个美观的仪表板来监控队列任务的运行状态、处理速度、失败任务等信息。使用 Horizon 可以更方便地管理基于 Redis 的队列系统，适合中大型项目。以下是完整的安装与配置流程。

安装 Horizon 扩展包

在 Laravel 项目根目录下执行以下命令来安装 Horizon：

安装完成后，Horizon 的核心文件会被引入到项目中。

发布 Horizon 资源文件

安装完成后，需要将 Horizon 的配置和前端资源文件发布到项目中：

该命令会生成 config/horizon.php 配置文件，并注册 Horizon 的路由。

配置 Redis 队列连接

Horizon 仅支持 Redis 作为队列驱动，因此需确保 .env 文件中的 QUEUE_CONNECTION 设置为 redis：

同时，在 config/database.php 中确认 Redis 配置正确，例如：

• 'redis' => [
•   'client' => 'predis',
•   'default' => [
•     'host' => env('REDIS_HOST', '127.0.0.1'),
•     'password' => env('REDIS_PASSWORD', null),
•     'port' => env('REDIS_PORT', 6379),
•     'database' => 0,
•   ]
• ]

配置 Horizon 监控策略

打开 config/horizon.php 文件，可以配置工作进程数量、队列平衡策略、环境监控等。例如：

• 'environments' => [
•   'production' => [
•     'supervisor-1' => [
•       'connection' => 'redis',
•       'queue' => ['default'],
•       'balance' => 'auto',
•       'processes' => 10,
•     ]
•   ],
•   'local' => [
•     'supervisor-1' => [
•       'connection' => 'redis',
•       'queue' => ['default'],
•       'balance' => 'simple',
•       'processes' => 3,
•     ]
•   ]
• ]

可以根据不同环境调整进程数和队列分配策略。

启用 Horizon 管理界面

Horizon 默认通过 /horizon 路由访问。为了安全，建议限制访问权限。可以在 app/Providers/HorizonServiceProvider.php 中设置授权逻辑：

修改 gate 方法，例如只允许本地访问或特定用户查看：

启动 Horizon 服务

使用以下命令启动 Horizon 监听队列：

启动后，Horizon 会持续监听 Redis 队列，并记录任务执行情况。

停止服务可使用：

访问 Horizon 仪表盘

启动服务后，在浏览器访问 http://your-app.test/horizon 即可查看队列监控面板。

面板中包含：

• 当前活跃队列和任务数
• 任务处理速率（jobs per minute）
• 最近失败任务列表
• 工作进程状态
• 内存与运行时间统计

常见问题处理

如果无法访问或数据不更新，请检查：

• 是否已运行 php artisan horizon
• Redis 服务是否正常运行
• 队列任务是否实际被推送到 Redis
• 是否清除了配置缓存（php artisan config:clear）
• 日志文件 storage/logs/laravel.log 是否有报错

基本上就这些。Horizon 让 Laravel 队列管理变得更直观高效，合理配置后能显著提升运维效率。