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 】

相关推荐： 移动端脚本框架Hammer.js  微信小程序 input输入框控件详解及实例（多种示例）  Laravel Docker环境搭建教程_Laravel Sail使用指南  如何在云主机快速搭建网站站点？  宙斯浏览器怎么屏蔽图片浏览 节省手机流量使用设置方法  如何使用 Go 正则表达式精准提取括号内首个纯字母标识符（忽略数字与嵌套）  香港服务器网站卡顿？如何解决网络延迟与负载问题？  BootStrap整体框架之基础布局组件  jQuery 常见小例汇总  Laravel项目如何进行性能优化_Laravel应用性能分析与优化技巧大全  网站制作软件免费下载安装,有哪些免费下载的软件网站？  免费网站制作appp,免费制作app哪个平台好？  ,怎么在广州志愿者网站注册？  Laravel Seeder填充数据教程_Laravel模型工厂Factory使用  如何在宝塔面板中创建新站点？  国美网站制作流程,国美电器蒸汽鍋怎么用官方网站？  Javascript中的事件循环是如何工作的_如何利用Javascript事件循环优化异步代码？  HTML5段落标签p和br怎么选_文本排版常用标签对比【解答】  Laravel如何创建自定义中间件？（Middleware代码示例）  为什么要用作用域操作符_php中访问类常量与静态属性的优势【解答】  如何为不同团队 ID 动态生成多个“认领值班”按钮  桂林网站制作公司有哪些,桂林马拉松怎么报名？  如何自定义建站之星网站的导航菜单样式？  如何将凡科建站内容保存为本地文件？  如何用腾讯建站主机快速创建免费网站？  Laravel如何实现图片防盗链功能_Laravel中间件验证Referer来源请求【方案】  如何在阿里云高效完成企业建站全流程？  Laravel如何生成和使用数据填充？（Seeder和Factory示例）  Laravel storage目录权限问题_Laravel文件写入权限设置  英语简历制作免费网站推荐,如何将简历翻译成英文？  悟空识字如何进行跟读录音_悟空识字开启麦克风权限与录音  如何快速搭建高效服务器建站系统？  Laravel如何实现RSS订阅源功能_Laravel动态生成网站XML格式订阅内容【教程】  大连 网站制作,大连天途有线官网？  Laravel全局作用域是什么_Laravel Eloquent Global Scopes应用指南  如何在局域网内绑定自建网站域名？  如何制作新型网站程序文件,新型止水鱼鳞网要拆除吗？  Laravel怎么实现验证码功能_Laravel集成验证码库防止机器人注册  Android仿QQ列表左滑删除操作  如何快速使用云服务器搭建个人网站？  JS经典正则表达式笔试题汇总  Python企业级消息系统教程_KafkaRabbitMQ高并发应用  大连网站制作公司哪家好一点,大连买房网站哪个好？  java中使用zxing批量生成二维码立牌  如何在Ubuntu系统下快速搭建WordPress个人网站？  Laravel怎么实现搜索高亮功能_Laravel结合Scout与Algolia全文检索【实战】  Laravel如何实现全文搜索功能？（Scout和Algolia示例）  Python自动化办公教程_ExcelWordPDF批量处理案例  手机网站制作平台,手机靓号代理商怎么制作属于自己的手机靓号网站？  如何在Windows环境下新建FTP站点并设置权限？