# Тривалі затримки

Робочі процеси можна призупиняти на визначений час між кроками за допомогою методу конструктора `delay()`. Кроки затримки є надійними: затримка зберігається в базі даних, тому переживає перезапуск воркерів, розгортання та перезавантаження сервера.

## Метод `->delay()`

Додайте крок затримки будь-де в ланцюжку робочого процесу:

```php
use Queuety\Queuety;

Queuety::workflow( 'drip_campaign' )
    ->then( SendWelcomeEmailHandler::class )
    ->delay( days: 1 )
    ->then( SendFollowUpEmailHandler::class )
    ->delay( days: 3 )
    ->then( SendFinalEmailHandler::class )
    ->dispatch( [ 'user_id' => 42 ] );
```

Робочий процес:

1. Запускає `SendWelcomeEmailHandler`
2. Чекає 1 день
3. Запускає `SendFollowUpEmailHandler`
4. Чекає 3 дні
5. Запускає `SendFinalEmailHandler`

## Параметри тривалості

Метод `delay()` приймає будь-яку комбінацію іменованих параметрів тривалості:

| Параметр | Тип | Опис |
|---|---|---|
| `$seconds` | `int` | Секунди очікування |
| `$minutes` | `int` | Хвилини очікування |
| `$hours` | `int` | Години очікування |
| `$days` | `int` | Дні очікування |

Усі значення додаються. Ось еквівалентні варіанти:

```php
->delay( seconds: 3600 )
->delay( minutes: 60 )
->delay( hours: 1 )
```

Їх можна поєднувати:

```php
->delay( hours: 1, minutes: 30 ) // 90 minutes total
```

## Як працюють кроки затримки

Коли робочий процес доходить до кроку затримки, Queuety створює внутрішнє завдання `__queuety_delay`, для стовпця `available_at` якого задається поточний час плюс тривалість затримки. Завдання зберігається в базі даних, і жоден воркер не отримує його, доки не мине затримка.

Це означає:

- **Без опитування.** Воркери не перевіряють затримку знову й знову. Коли настає потрібний час, завдання просто стає доступним.
- **Без використання пам’яті.** Під час очікування нічого не виконується. Затримка існує лише як рядок у базі даних.
- **Переживає перезапуски.** Навіть якщо воркер перезапуститься, завдання затримки залишиться в черзі з правильною часовою позначкою `available_at`.

Коли після затримки завдання буде отримано, робочий процес автоматично перейде до наступного кроку.

## Приклад: відкладені сповіщення

Надішліть нагадування через 1 годину після реєстрації користувача, але лише якщо він ще не завершив ознайомлення:

```php
Queuety::workflow( 'onboarding_reminder' )
    ->then( CreateAccountHandler::class )
    ->delay( hours: 1 )
    ->then( CheckOnboardingHandler::class )
    ->then( SendReminderHandler::class )
    ->dispatch( [ 'email' => 'user@example.com' ] );
```

Крок `CheckOnboardingHandler` може перевірити стан і застосувати [умовне розгалуження](https://queuety.inline0.dev/uk/docs/workflows/conditional), щоб пропустити нагадування, якщо ознайомлення вже завершено.

## Приклад: повторна спроба із затримкою

Додавайте затримки між кроками, схожими на повторні спроби:

```php
Queuety::workflow( 'poll_external_api' )
    ->then( CheckStatusHandler::class, 'check' )
    ->delay( minutes: 5 )
    ->then( CheckStatusHandler::class, 'recheck' )
    ->delay( minutes: 15 )
    ->then( CheckStatusHandler::class, 'final_check' )
    ->then( ProcessResultHandler::class )
    ->dispatch( [ 'external_id' => 'abc-123' ] );
```

## Кілька затримок

Робочий процес може містити будь-яку кількість кроків затримки. Кожна затримка є незалежною та відстежується за послідовним ім’ям (`delay_0`, `delay_1` тощо) у стані робочого процесу.

```php
Queuety::workflow( 'multi_step_drip' )
    ->then( StepA::class )
    ->delay( hours: 2 )
    ->then( StepB::class )
    ->delay( days: 1 )
    ->then( StepC::class )
    ->delay( minutes: 30 )
    ->then( StepD::class )
    ->dispatch( $payload );
```