0Pricing
PHP Academy · 课时

使用 Laravel Horizon 监控队列

安装 Horizon，并观察队列吞吐量和失败任务。

使用 Laravel Horizon 监控队列 是 CoddyKit 上的免费 PHP Academy 课时。 这是第 4 节课，共 4 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 PHP Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 PHP Academy 课程共包含 4 节课。

什么是 Horizon？

Laravel Horizon 为 Redis 支持的队列提供美观的控制面板和配置系统，包括实时指标、吞吐量跟踪和任务监控。

安装 Horizon

通过 Composer 安装并发布资源。

$ composer require laravel/horizon
$ php artisan horizon:install
$ php artisan migrate

启动 Horizon

将 Horizon 作为单个长期运行的进程启动（取代 queue:work）。

$ php artisan horizon

访问控制面板

Horizon 控制面板默认位于 /horizon。在生产环境中，仅允许已授权用户通过 Gate 访问。

<?php
// In HorizonServiceProvider:
Horizon::auth(function ($request) {
    return $request->user()?->isAdmin() ?? false;
});

horizon.php 配置

在 config/horizon.php 中配置工作进程（环境、监管程序、队列优先级和工作进程数量）。

// config/horizon.php
"environments" => [
    "production" => [
        "supervisor-1" => [
            "connection" => "redis",
            "queue"      => ["emails", "default"],
            "processes"  => 10,
            "balance"    => "auto",
        ]
    ]
]

监管程序与负载均衡

Horizon 监管程序负责管理工作进程池。使用 "balance" => "auto" 时，Horizon 会根据队列深度自动扩展工作进程。

指标控制面板

Horizon 控制面板会显示：每分钟任务数、失败的任务、等待时间、最近的任务以及各队列的统计信息。

为任务添加标签

为任务添加标签，以便在控制面板中更轻松地监控和筛选。

<?php
public function tags(): array
{
    return ["user:".$this->user->id, "email"];
}
// Then filter by tag in the Horizon dashboard

Horizon 中的失败任务

查看失败作业及其异常和堆栈跟踪。您可以直接从仪表板或通过 Artisan 重试单个失败作业。

$ php artisan horizon:forget <uuid>
$ php artisan horizon:retry-failed

使用 Supervisor 在生产环境中运行

使用 Linux Supervisor 保持 Horizon 进程运行，并在进程崩溃时重新启动它。

[program:horizon]
command=php /srv/app/artisan horizon
autorestart=true
stdout_logfile=/var/log/horizon.log

暂停与继续

部署期间暂停 Horizon，以便优雅地排空队列，然后继续运行。

$ php artisan horizon:pause
$ php artisan horizon:continue
$ php artisan horizon:terminate

总结

Horizon 使用单个进程和美观的仪表板取代队列工作进程。在 config/horizon.php 中配置工作进程数量。在生产环境中使用 Supervisor 保持 Horizon 运行。

快速检查

哪个命令可以启动 Laravel Horizon？

常见问题解答

「使用 Laravel Horizon 监控队列」课时是免费的吗？

是的 — 「使用 Laravel Horizon 监控队列」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 PHP Academy 课程的其余内容，请升级到 CoddyKit PRO。 PHP Academy 课程共包含 4 节课。

「使用 Laravel Horizon 监控队列」这节课中我会学到什么？

安装 Horizon，并观察队列吞吐量和失败任务。 你通过在浏览器中直接运行的动手代码来练习 PHP Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。

学习 PHP Academy 需要有经验吗？

无需任何先前经验。CoddyKit 上的 PHP Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 4 节课，共 4 节。

「使用 Laravel Horizon 监控队列」课时需要多长时间？

大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。

我能在这节 PHP Academy 课中编写并运行代码吗？

能。每节 PHP Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。

此课程中的所有课时

  1. 队列概念与驱动
  2. 创建和分发任务
  3. 任务重试、延迟与链式执行
  4. 使用 Laravel Horizon 监控队列
← 返回 PHP Academy