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：
composer require laravel/horizon安装完成后，Horizon 的核心文件会被引入到项目中。
发布 Horizon 资源文件
安装完成后，需要将 Horizon 的配置和前端资源文件发布到项目中：
php artisan horizon:install该命令会生成 config/horizon.php 配置文件，并注册 Horizon 的路由。
配置 Redis 队列连接
Horizon 仅支持 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 监控策略
打开 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 方法，例如只允许本地访问或特定用户查看：
if ($this->app->environment('local')) {return true;
}
return request()->user() && in_array(request()->user()->email, [
'admin@example.com'
]);
启动 Horizon 服务
使用以下命令启动 Horizon 监听队列：
php artisan horizon启动后，Horizon 会持续监听 Redis 队列，并记录任务执行情况。
停止服务可使用：
php artisan horizon:terminate访问 Horizon 仪表盘
启动服务后，在浏览器访问 http://your-app.test/horizon 即可查看队列监控面板。
面板中包含：
- 当前活跃队列和任务数
- 任务处理速率（jobs per minute）
- 最近失败任务列表
- 工作进程状态
- 内存与运行时间统计
常见问题处理
如果无法访问或数据不更新，请检查：
- 是否已运行 php artisan horizon
- Redis 服务是否正常运行
- 队列任务是否实际被推送到 Redis
- 是否清除了配置缓存（php artisan config:clear）
- 日志文件 storage/logs/laravel.log 是否有报错
基本上就这些。Horizon 让 Laravel 队列管理变得更直观高效，合理配置后能显著提升运维效率。
