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 】

相关推荐： 详解jQuery停止动画——stop()方法的使用  php中::能调用final静态方法吗_final修饰静态方法调用规则【解答】  javascript读取文本节点方法小结  米侠浏览器网页背景异常怎么办 米侠显示修复  Win11怎么更改系统语言为中文_Windows11安装语言包并设为显示语言  Laravel如何处理CORS跨域请求？（配置示例）  如何在Windows服务器上快速搭建网站？  潮流网站制作头像软件下载,适合母子的网名有哪些？  JavaScript 输出显示内容(document.write、alert、innerHTML、console.log)  电视网站制作tvbox接口,云海电视怎样自定义添加电视源？  公司门户网站制作公司有哪些,怎样使用wordpress制作一个企业网站？  Laravel如何使用Eloquent进行子查询  Javascript中的事件循环是如何工作的_如何利用Javascript事件循环优化异步代码？  如何用虚拟主机快速搭建网站？详细步骤解析  Laravel如何实现数据导出到PDF_Laravel使用snappy生成网页快照PDF【方案】  魔毅自助建站系统：模板定制与SEO优化一键生成指南  Android实现代码画虚线边框背景效果  JavaScript如何实现错误处理_try...catch如何捕获异常？  英语简历制作免费网站推荐,如何将简历翻译成英文？  如何快速搭建高效WAP手机网站？  Laravel distinct去重查询_Laravel Eloquent去重方法  QQ浏览器网页版登录入口 个人中心在线进入  Laravel Sail是什么_基于Docker的Laravel本地开发环境Sail入门  教你用AI润色文章，让你的文字表达更专业  Win11任务栏卡死怎么办 Windows11任务栏无反应解决方法【教程】  Linux系统命令中screen命令详解  🚀拖拽式CMS建站能否实现高效与个性化并存？  Laravel如何使用集合（Collections）进行数据处理_Laravel Collection常用方法与技巧  智能起名网站制作软件有哪些,制作logo的软件？  香港服务器建站指南：外贸独立站搭建与跨境电商配置流程  如何在新浪SAE免费搭建个人博客？  Laravel中DTO是什么概念_在Laravel项目中使用数据传输对象(DTO)  小米17系列还有一款新机？主打6.9英寸大直屏和旗舰级影像  Laravel如何监控和管理失败的队列任务_Laravel失败任务处理与监控  HTML透明颜色代码在Angular里怎么设置_Angular透明颜色使用指南【详解】  高端企业智能建站程序：SEO优化与响应式模板定制开发  UC浏览器如何切换小说阅读源_UC浏览器阅读源切换【方法】  Laravel Eloquent访问器与修改器是什么_Laravel Accessors & Mutators数据处理技巧  大型企业网站制作流程,做网站需要注册公司吗？  详解Oracle修改字段类型方法总结  Laravel怎么发送邮件_Laravel Mail类SMTP配置教程  Laravel如何升级到最新版本？（升级指南和步骤）  Laravel如何使用Service Container和依赖注入？（代码示例）  ChatGPT 4.0官网入口地址 ChatGPT在线体验官网  如何将凡科建站内容保存为本地文件？  Win11搜索不到蓝牙耳机怎么办 Win11蓝牙驱动更新修复【详解】  如何在IIS中配置站点IP、端口及主机头？  Laravel怎么使用Session存储数据_Laravel会话管理与自定义驱动配置【详解】  使用spring连接及操作mongodb3.0实例  如何在阿里云虚拟主机上快速搭建个人网站？