Laravel如何配置Horizon来管理队列？（安装和使用）-Laravel-PHP中文网

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

穿越時空

发布： 2025-12-14 21:56:03

原创

311人浏览过

Horizon 是 Laravel 官方 Redis 队列监控工具，需安装扩展、发布配置与迁移、配置环境参数、用 Supervisor 守护进程，并启用 Web 控制台实现队列实时管理。

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

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 命令，需用进程管理器长期运行：

bee餐饮点餐外卖小程序

bee餐饮点餐外卖小程序是针对餐饮行业推出的一套完整的餐饮解决方案，实现了用户在线点餐下单、外卖、叫号排队、支付、配送等功能，完美的使餐饮行业更高效便捷！功能演示：1、桌号管理登录后台，左侧菜单 “桌号管理”，添加并管理你的桌号信息，添加以后在列表你将可以看到 ID 和密钥，这两个数据用来生成桌子的二维码2、生成桌子二维码例如上面的ID为 308，密钥为 d3PiIY，那么现在去左侧菜单微信设置

查看详情

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

以上就是Laravel如何配置Horizon来管理队列？（安装和使用）的详细内容，更多请关注php中文网其它相关文章！