Как работают очередь задач в Laravel?

Question

Accepted Answer

**Система очередей** Laravel позволяет отложить выполнение трудоёмких задач (отправка писем, обработка файлов, вызовы медленных API) на **фоновое выполнение**, так что пользователь получает быстрый ответ. Задачи инкапсулируются как **Jobs**, добавляются в очередь и обрабатываются отдельными процессами-**workers**.

## Проблема, которую решают очереди

```text
Slow work done inline makes the user wait and risks request timeouts:
  ✗ sending emails, processing images/video, generating reports, calling slow APIs
  ✓ QUEUE it → respond to the user immediately → a worker handles it in the background
```

## Определение и отправка задачи

```php
<?php
// php artisan make:job ProcessPodcast
class ProcessPodcast implements ShouldQueue {
    public function __construct(public Podcast $podcast) {}

public function handle(): void {
        // the slow work — runs in a WORKER, not the web request
        $this->podcast->process();
    }
}
```

```php
// dispatch the job — pushes it onto the queue, returns IMMEDIATELY
ProcessPodcast::dispatch($podcast);
ProcessPodcast::dispatch($podcast)->delay(now()->addMinutes(10));   // delayed
```

Реализация интерфейса `ShouldQueue` делает задачу ставимой в очередь. `dispatch()` добавляет её в очередь и возвращает управление немедленно — пользователь не ждёт выполнения работы.

## Обработка задач (workers)

```bash
php artisan queue:work          # run a worker to process queued jobs
# in production: run workers as a supervised process (Supervisor) or use Horizon
```

Отдельный процесс-**worker** извлекает задачи из очереди и выполняет их. Бэкенды очередей включают Redis, базу данных, SQS и т. д.

## Возможности надёжности

```php
class ProcessPodcast implements ShouldQueue {
    public $tries = 3;             // retry up to 3 times on failure
    public $backoff = 60;          // wait 60s between retries
    public function failed(Throwable $e): void { /* handle final failure */ }
}
```

```text
✓ Retries with backoff (resilience), failed-job handling
✓ Persistence (jobs survive restarts via the queue backend)
✓ Laravel Horizon → a dashboard for monitoring/managing Redis queues
```

## Почему это важно

Очередные задачи являются необходимым компонентом для создания отзывчивых и масштабируемых приложений Laravel — перенос медленной или отложенной работы из цикла обработки запроса является распространённой и важной необходимостью, и система очередей Laravel делает это элегантно.

Понимание этого ценно, так как выполнение трудоёмких операций встроенно (отправка писем, обработка медиа, создание отчётов, вызовы медленных внешних сервисов) заставляет пользователей ждать, рискует таймаутами запросов и приводит к потере работы при сбое — тогда как **постановка в очередь** позволяет немедленно ответить пользователю, пока фоновый **worker** обрабатывает её надёжно.

Помимо простого асинхронного перенесения работы, очереди Laravel предоставляют важные производственные возможности: **автоматические повторы с экспоненциальной задержкой** (устойчивость к временным сбоям), **сохранение** (задачи сохраняются в бэкенде очереди при сбоях/перезагрузках, поэтому работа не теряется), обработка неудачных задач, отложенная отправка и мониторинг через Horizon.

Понимание того, как определять задачи (`ShouldQueue`), отправлять их (возвращаясь немедленно), обрабатывать их с помощью workers (`queue:work`, управляемых в production), и настраивать функции надёжности — это важные знания для создания приложений, которые элегантно справляются с тяжёлой или отложенной работой.

Поскольку отзывчивые приложения регулярно должны переносить работу на фон — и поскольку система очередей Laravel является элегантным, идиоматичным способом сделать это со встроенной надёжностью — освоение задач и очередей — это часто применяемое, важное знание для создания приложений Laravel production-уровня, которые остаются быстрыми и надёжными под реальными рабочими нагрузками.