Laravel Horizon 是一個(gè)專(zhuān)為 Laravel 的 Redis 隊(duì)列設(shè)計(jì)的儀表板和代碼驅(qū)動(dòng)配置工具，它提供隊(duì)列系統(tǒng)的深度洞察。1. 安裝前需確保使用 Redis 作為隊(duì)列驅(qū)動(dòng)，并通過(guò) Composer 安裝 Horizon。2. 發(fā)布其資源后，可在 config/horizon.php 中配置監(jiān)控選項(xiàng)，例如連接、隊(duì)列名稱(chēng)、進(jìn)程數(shù)等。3. 安裝完成后訪問(wèn) /horizon 可查看實(shí)時(shí)統(tǒng)計(jì)信息并設(shè)置通知機(jī)制。4. 在生產(chǎn)環(huán)境中運(yùn)行時(shí)建議使用 Supervisor 等進(jìn)程管理工具保持運(yùn)行，并在部署新代碼后清除并重啟 Horizon。5. 對(duì)于 Forge 或 Vapor 等平臺(tái)，則可利用內(nèi)置功能簡(jiǎn)化部署流程。

Laravel Horizon is a powerful, built-in dashboard and code-driven configuration system for managing your Redis queues in Laravel. It gives you deep insight into your queue system — from job throughput to failure tracking and even performance monitoring. If you're using Redis as your queue driver and want more control and visibility, Horizon is the tool to use.

Installing and Configuring Laravel Horizon

First things first: make sure you’re using Redis as your queue driver. Horizon only works with Redis, so that’s non-negotiable. You can set this up in your .env file by setting QUEUE_CONNECTION=redis.

Once Redis is ready, install Horizon via Composer:

composer require laravel/horizon

Then publish its assets with:

php artisan horizon:install

This creates the Horizon command in your App\Console\Kernel and sets up the views needed for the dashboard. Also, it adds a service provider so everything gets wired up automatically.

The main config file is at config/horizon.php. Here, you define your queue supervision settings — like which queues to monitor, how many workers to run per queue, and how long jobs should be allowed to run before timing out.

A common setup might look like:

'environments' => [
    'production' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => ['default'],
            'balance' => 'simple',
            'processes' => 10,
            'tries' => 3,
        ],
    ],
],

You can tweak these values based on your app's needs. For example, high-priority queues might get more processes or shorter timeouts.

Using the Horizon Dashboard

After installing, access the Horizon dashboard by visiting /horizon in your browser. By default, it’s protected in local environments only, but you can adjust middleware to allow authenticated users in production.

From here, you’ll see real-time stats on:

• Active jobs
• Failed jobs
• Throughput (jobs per minute)
• Runtime averages
• Queue wait times

One of the most useful parts is the "Monitoring" tab, where you can set up alerts for stalled jobs or long wait times. For instance, if a queue starts backing up, Horizon can notify you via email or Slack — assuming you've configured those notifications.

To enable notifications, you'll need to use Laravel's built-in notification system. In your HorizonServiceProvider, you can specify who gets notified when certain events happen:

Horizon::night();

Horizon::when('failed', function ($event) {
    return $event->type === 'job_failed';
});

This kind of setup helps you catch bottlenecks before they become serious issues.

Running Horizon in Production

Running Horizon in production requires a process monitor to keep the supervisor running. Most people use Supervisor on Ubuntu or similar systems.

Here’s a basic Supervisor config:

[program:horizon]
command=php /path/to/artisan horizon
directory=/path/to/laravel
autostart=true
autorestart=true
user=www-data
redirect_stderr=true
stdout_logfile=/path/to/logs/horizon.log

This ensures Horizon restarts automatically if it crashes and keeps your queues running smoothly.

If you're deploying on platforms like Forge or Vapor, there are usually built-in tools or deployment hooks to manage Horizon without manual setup.

Also, remember to clear and restart Horizon after deploying new code:

php artisan horizon:clear
php artisan horizon:terminate

These commands help avoid outdated jobs lingering and ensure fresh workers pick up the latest changes.

That's pretty much what you need to know to get started with Laravel Horizon. Once it's running, you’ll wonder how you ever managed without it.

以上是用Laravel Horizo??n設(shè)置和監(jiān)視隊(duì)列的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！