⚡ Esora Документация

Очереди

Назначение и когда использовать

Очередь выносит медленную работу из HTTP. Выбирайте sync для локальной проверки, memory для ephemeral процесса, database для durable jobs.

Настройка и регистрация job

config/queue.php: default из QUEUE_CONNECTION; database connection задаёт driver=database и table=jobs. Job реализует:

use Esora\Queue\JobInterface;

final class SendReport implements JobInterface
{
    public function __construct(private readonly int $reportId) {}
    public function handle(): void { /* отправка отчёта */ }
    public function failed(?\Throwable $e): void { /* лог/уведомление */ }
    public function getTries(): int { return 3; }
    public function getTimeout(): int { return 60; }
}

QueueManager::push(JobInterface $job, string $queue = 'default', int $delay = 0) возвращает ID. connection(?string $name = null) возвращает QueueDriverInterface; у драйвера есть push, pop, delete, size.

$queue->push(new SendReport(42), 'reports', 30);

Запустите worker:

php bin/console queue:work --connection=database --queue=reports --sleep=2

Опция --once обрабатывает одну job, --max-jobs=N ограничивает daemon.

Lifecycle и troubleshooting

push → driver storage → Worker::pop → handle() → success/delete либо failed(Throwable). Для database driver нужен зарегистрированный Connection; иначе QueueManager выбросит InvalidArgumentException. Если job не обрабатывается, проверьте default connection, queue name и процесс worker.