Laravel Horizon

composer require laravel/horizon

php artisan horizon:install

'environments' => [
    'production' => [
        'supervisor-1' => [
            'connection' => 'redis',
            'queue' => ['default', 'notifications'],
            'balance' => 'auto',
            'autoScalingStrategy' => 'time',
            'minProcesses' => 1,
            'maxProcesses' => 10,
            'balanceMaxShift' => 1,
            'balanceCooldown' => 3,
            'tries' => 3,
            'timeout' => 60,
        ],
    ],

    'local' => [
        'supervisor-1' => [
            // 그 외의 값은 defaults 섹션에서 상속됩니다
            'maxProcesses' => 3,
        ],
    ],
],

use Closure;
use Illuminate\Http\Request;
use Laravel\Horizon\Horizon;
use Symfony\Component\HttpFoundation\Response;

public function handle(Request $request, Closure $next): Response
{
    Horizon::cspNonce('csp-nonce');

    return $next($request);
}

'middleware' => [
    'web',
    App\Http\Middleware\AddHorizonCspNonce::class,
],

'defaults' => [
    'supervisor-1' => [
        'connection' => 'redis',
        'queue' => ['default'],
        'balance' => 'auto',
        'tries' => 1,
        'timeout' => 60,
        'maxProcesses' => 1,
    ],
],

'environments' => [
    'production' => [
        'supervisor-1' => [
            'force' => true,
        ],
    ],
],

'environments' => [
    'production' => [
        'supervisor-1' => [
            'tries' => 10,
        ],
    ],
],

'environments' => [
    'production' => [
        'supervisor-1' => [
            'timeout' => 60,
        ],
    ],
],

// 고정값
'backoff' => 10,

// 단계적 (지수 백오프)
'backoff' => [1, 5, 10],

'environments' => [
    'production' => [
        'supervisor-1' => [
            // ...
            'memory' => 128,
            'maxJobs' => 1000,
            'maxTime' => 3600,
            'sleep' => 3,
            'rest' => 0,
            'nice' => 0,
        ],
    ],
],

use App\Models\User;
use Illuminate\Support\Facades\Gate;

protected function gate(): void
{
    Gate::define('viewHorizon', function (User $user) {
        return in_array($user->email, [
            '[email protected]',
        ]);
    });
}

Gate::define('viewHorizon', function (User $user = null) {
    // IP 주소 등으로 제한하는 경우
    return true;
});

# 시작
php artisan horizon

# 일시 정지 / 재개
php artisan horizon:pause
php artisan horizon:continue

# 특정 슈퍼바이저의 일시 정지 / 재개
php artisan horizon:pause-supervisor supervisor-1
php artisan horizon:continue-supervisor supervisor-1

# 상태 확인
php artisan horizon:status
php artisan horizon:supervisor-status supervisor-1

# 그레이스풀 셧다운
php artisan horizon:terminate

npm install --save-dev chokidar
php artisan horizon:listen

# Docker / Vagrant 환경에서는
php artisan horizon:listen --poll

sudo apt-get install supervisor

[program:horizon]
process_name=%(program_name)s
command=php /home/forge/example.com/artisan horizon
autostart=true
autorestart=true
user=forge
redirect_stderr=true
stdout_logfile=/home/forge/example.com/horizon.log
stopwaitsecs=3600

sudo supervisorctl reread
sudo supervisorctl update
sudo supervisorctl start horizon

php artisan horizon:terminate

// Video 모델(id=1)을 받는 잡 → 자동으로 "App\Models\Video:1" 태그가 붙음
RenderVideo::dispatch(Video::find(1));

class RenderVideo implements ShouldQueue
{
    /**
     * @return array<int, string>
     */
    public function tags(): array
    {
        return ['render', 'video:'.$this->video->id];
    }
}

class SendRenderNotifications implements ShouldQueue
{
    public function tags(VideoRendered $event): array
    {
        return ['video:'.$event->video->id];
    }
}

'silenced' => [
    App\Jobs\ProcessPodcast::class,
],

// 태그 단위로 사일런싱
'silenced_tags' => [
    'notifications',
],

use Laravel\Horizon\Contracts\Silenced;

class ProcessPodcast implements ShouldQueue, Silenced
{
    use Queueable;
    // ...
}

// routes/console.php
use Illuminate\Support\Facades\Schedule;

Schedule::command('horizon:snapshot')->everyFiveMinutes();

'metrics' => [
    'trim_snapshots' => [
        'job' => 24,
        'queue' => 24,
    ],
],

php artisan horizon:clear-metrics

use Laravel\Horizon\Horizon;

public function boot(): void
{
    parent::boot();

    Horizon::routeMailNotificationsTo('[email protected]');
    Horizon::routeSlackNotificationsTo('slack-webhook-url', '#ops');
    Horizon::routeSmsNotificationsTo('15556667777');
}

'waits' => [
    'redis:critical' => 30,  // 30초 이상 대기 시 알림
    'redis:default' => 60,
    'redis:batch' => 120,
],

# 특정 실패 잡 삭제
php artisan horizon:forget 5

# 모든 실패 잡 삭제
php artisan horizon:forget --all

# 기본 큐를 지움
php artisan horizon:clear

# 특정 큐를 지움
php artisan horizon:clear --queue=emails