Очереди
Назначение и когда использовать
Очередь выносит медленную работу из 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.