Laravel如何配置Horizon来管理队列？（安装和使用）_网络技术

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

发布时间 - 2025-12-14 00:00:00 点击率：次

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 不复杂但容易忽略配置生效和进程守护这两步，配好后队列状态一目了然，失败任务也不再“石沉大海”。

# php # laravel # redis # 前端 # composer # app # 工具 # ai # 开发环境 # red # require # 并发 # function # default # https # 重试 # 是一个 # 首次 # 还能 # 石沉大海 # 设为 # 管理器 # 自带 # 等功能 # 可直接

相关栏目：【网站优化151355 】【网络推广146373 】【网络技术251813 】【 AI营销90571 】

上一篇：谷歌浏览器下载文件时中断怎么办 Google Chrome下

下一篇：Laravel如何生成URL和重定向？（路由助手函数）

相关栏目网站优化
网络推广
网络技术
AI营销

最新文章 Sublime怎么一键压缩JS代码 Su sublime如何在搜索中使用正则表达式 Sublime如何设置透明窗口效果 Su mysql如何设计商品表结构_mysql css属性背景图不显示怎么办_通过检查路如何使用Golang实现排序_Golan 农历闰月是怎么回事_为合回归年加一月调整塑造《刺客信条》艾吉奥传奇的编剧离开育碧 1英里等于多少公里 1mile和km的换 css grid布局中行和列是如何定义的 PS批量旋转和翻转图片，快速校正图片方向 C# Swagger UI自定义方法 C OPPO手机九宫格和全键盘怎么切换_OP Go语言如何实现用户登录注册_Golan 1节飞行速度多少公里每小时 1节是多少公纸嫁衣8千子树第五章庙门怎么开启庙门 Laravel 多行数据编辑表单中实现逐明日之后如何提升钓鱼等级明日之后提升钓支付宝怎样查年度账单_支付宝年度账单查看 C# 多线程UI更新Dispatcher

上一篇：谷歌浏览器下载文件时中断怎么办 Google Chrome下

下一篇：Laravel如何生成URL和重定向？（路由助手函数）