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 artisan horizon（Ctrl+C 停止） - 生产环境推荐用 Supervisor 管理。示例配置片段（
/etc/supervisor/conf.d/horizon.conf）：
[program:horizon] process_name=%(program_name)s command=php /var/www/your-app/artisan horizon autostart=true autorestart=true user=www-data redirect_stderr=true stdout_logfile=/var/www/your-app/storage/logs/horizon.log
保存后执行：sudo supervisorctl reread && sudo supervisorctl update && sudo supervisorctl start horizon
访问 Horizon 控制台与基础操作
Horizon 自带 Web 界面，默认路径为 /horizon（如 https://yoursite.test/horizon）。首次访问需满足：
- 在
App\Providers\AppServiceProvider的boot()方法中添加：\Laravel\Horizon\Horizon::auth(function ($request) { return true; });（仅开发环境；生产环境建议加权限判断） - 确保已运行
php artisan horizon:publish（发布前端资源，Laravel 9+ 通常自动完成）
界面中可查看：当前活跃进程、队列延迟、最近任务、失败任务列表、重试/删除单个或批量失败作业等。点击「Supervisors」还能看到每个 supervisor 的实时负载与重启次数。
基本上就这些。Horizon 不复杂但容易忽略配置生效和进程守护这两步，配好后队列状态一目了然，失败任务也不再“石沉大海”。
