laravel horizon通过可视化仪表盘监控redis队列，需安装包并发布配置文件，设置queue_connection=redis，配置redis连接信息，定义horizon.php中的工作进程策略，启动php artisan horizon服务，限制访问权限后即可查看任务状态、失败日志及吞吐量。
Laravel Horizon 是一个优雅的 Redis 队列监控和管理工具，它为 Laravel 的队列系统提供了可视化的仪表盘，能实时查看任务处理情况、失败任务、吞吐量、工作进程状态等。要配置和使用 Horizon 监控 Redis 队列，需完成几个关键步骤。
安装和配置 Horizon
要在 Laravel 项目中启用 Horizon，先通过 Composer 安装包：
composer require laravel/horizon安装完成后，发布 Horizon 的配置文件和资源：
php artisan horizon:install php artisan vendor:publish --provider="Laravel\Horizon\HorizonServiceProvider"这会生成 config/horizon.php 配置文件，用于定义工作进程环境、队列平衡策略、速率限制等。
配置 Redis 连接
确保 .env 文件中的 QUEUE_CONNECTION 设置为 redis：
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 使用 Redis 存储队列数据，因此必须确保 Redis 正常运行且可连接。
配置 Horizon 工作环境
打开 config/horizon.php，可以设置不同环境下（如 local、production）的工作进程数量和监听的队列。例如：
'environments' => [
'local' => [
'supervisor-1' => [
'connection' => 'redis',
'queue' => ['default'],
'balance' => 'auto',
'processes' => 3,
'tries' => 3,
],
],
],
上面配置表示在本地环境中启动一个名为 supervisor-1 的工作进程组，使用 redis 连接，监听 default 队列，最多开启 3 个进程，每个任务最多尝试 3 次。
启动 Horizon 服务
使用以下命令启动 Horizon：
php artisan horizon该命令会启动 Horizon 的守护进程，开始监听 Redis 中的队列任务。你可以通过 Supervisor 等进程管理工具将其常驻后台运行。
访问 Horizon 仪表盘，默认路径是 /horizon。你可以在 routes/web.php 或服务提供者中控制访问权限：
Horizon::auth(function ($request) {
return app()->environment('local') || $request->user()?->hasRole('admin');
});
这样可以限制只有管理员或本地环境才能访问监控页面。
查看队列状态和调试任务
进入 Horizon 仪表盘后，可以看到：
- 当前活跃的任务数
- 最近处理的任务列表
- 失败任务日志及重试功能
- 每秒处理任务的吞吐量
- 各工作进程的状态和内存使用
如果某个任务失败，Horizon 会自动记录到 failed_jobs 表，你可以在界面上点击重试，或使用命令行清理：
php artisan horizon:clear此命令清除当前所有待处理和失败任务（谨慎使用）。
基本上就这些。配置好 Horizon 后，Redis 队列变得可视化、易管理，特别适合中大型项目中的异步任务监控。只要确保 Redis 稳定、队列驱动正确，并合理设置工作进程数，就能高效利用 Horizon 提升运维效率。
