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 】

相关推荐： 如何快速搭建高效WAP手机网站吸引移动用户？  Laravel如何处理文件上传_Laravel Storage门面实现文件存储与管理  网站建设要注意的标准 促进网站用户好感度！  消息称 OpenAI 正研发的神秘硬件设备或为智能笔，富士康代工  Laravel与Inertia.js怎么结合_使用Laravel和Inertia构建现代单页应用  黑客入侵网站服务器的常见手法有哪些？  韩国服务器如何优化跨境访问实现高效连接？  Laravel如何配置和使用队列处理异步任务_Laravel队列驱动与任务分发实例  如何用y主机助手快速搭建网站？  如何正确下载安装西数主机建站助手？  昵图网官方站入口 昵图网素材图库官网入口  Python数据仓库与ETL构建实战_Airflow调度流程详解  利用JavaScript实现拖拽改变元素大小  制作企业网站建设方案,怎样建设一个公司网站？  千问怎样用提示词获取健康建议_千问健康类提示词注意事项【指南】  Laravel事件监听器怎么写_Laravel Event和Listener使用教程  浏览器如何快速切换搜索引擎_在地址栏使用不同搜索引擎【搜索】  如何用AI帮你把自己的生活经历写成一个有趣的故事？  Android okhttputils现在进度显示实例代码  logo在线制作免费网站在线制作好吗,DW网页制作时，如何在网页标题前加上logo？  韩国网站服务器搭建指南：VPS选购、域名解析与DNS配置推荐  Laravel怎么自定义错误页面_Laravel修改404和500页面模板  php在windows下怎么调试_phpwindows环境调试操作说明【操作】  黑客如何通过漏洞一步步攻陷网站服务器？  Laravel如何实现URL美化Slug功能_Laravel使用eloquent-sluggable生成别名【方法】  香港服务器租用费用高吗？如何避免常见误区？  Laravel怎么在Controller之外的地方验证数据  html文件怎么打开证书错误_https协议的html打开提示不安全【指南】  Laravel Seeder填充数据教程_Laravel模型工厂Factory使用  JavaScript如何实现错误处理_try...catch如何捕获异常？  高端建站三要素：定制模板、企业官网与响应式设计优化  Laravel怎么生成二维码图片_Laravel集成Simple-QrCode扩展包与参数设置【实战】  Swift中swift中的switch 语句  如何在云虚拟主机上快速搭建个人网站？  laravel服务容器和依赖注入怎么理解_laravel服务容器与依赖注入解析  再谈Python中的字符串与字符编码（推荐）  Laravel如何使用Sanctum进行API认证？（SPA实战）  微博html5版本怎么弄发超话_超话进入入口及发帖格式要求【教程】  Python自动化办公教程_ExcelWordPDF批量处理案例  如何为不同团队 ID 动态生成多个“认领值班”按钮  米侠浏览器网页背景异常怎么办 米侠显示修复  详解Android中Activity的四大启动模式实验简述  弹幕视频网站制作教程下载,弹幕视频网站是什么意思？  Laravel如何处理JSON字段_Eloquent原生JSON字段类型操作教程  Win11怎么设置默认图片查看器_Windows11照片应用关联设置  EditPlus中的正则表达式 实战(4)  如何在云指建站中生成FTP站点？  如何快速搭建FTP站点实现文件共享？  Laravel如何使用Seeder填充数据_Laravel模型工厂Factory批量生成测试数据【方法】  大连 网站制作,大连天途有线官网？