---
title: "Laravel 13.43: атрибут RetryFor, releaseUsingBackoff() і повтори Predis після обриву з'єднання"
url: https://laravelukraine.com/blog/laravel-1343-atribut-retryfor-releaseusingbackoff-i-povtori-predis-pislia-obrivu-zjednannia
date: 2026-11-19
---

# Laravel 13.43: атрибут RetryFor, releaseUsingBackoff() і повтори Predis після обриву з'єднання

[Laravel 13.43.0](https://github.com/laravel/framework/releases/tag/v13.43.0) вийшов 17 листопада, і найпомітніше в ньому стосується черг: дві зміни прибирають код, який досі доводилося писати руками в кожному другому завданні, а третя закриває давню проблему довгоживучих воркерів і Octane, що працюють з Redis через Predis за балансувальником. Поруч - правила валідації, виведені прямо з JSON-схеми, і кілька дрібніших API.

### Вікно повторних спроб атрибутом

Атрибути `#[Tries]`, `#[Backoff]`, `#[Timeout]` і `#[UniqueFor]` у Laravel 13 уже є, а от вікно повторних спроб досі вимагало методу: дедлайн рахується від моменту постановки в чергу, тож у властивість його не запишеш. Тепер для цього є `#[RetryFor]` ([#62434](https://github.com/laravel/framework/pull/62434)):

```php
// Раніше
class ProcessPodcast implements ShouldQueue
{
  public function retryUntil(): DateTime
  {
    return now()->addHour();
  }
}

// Тепер
use Illuminate\Queue\Attributes\RetryFor;

#[RetryFor(hours: 1)]
class ProcessPodcast implements ShouldQueue
{
  //
}
```

Перший аргумент - секунди, як і в інших атрибутах черги, а `minutes` і `hours` передаються за назвою і додаються: `#[RetryFor(90)]`, `#[RetryFor(minutes: 10)]`, `#[RetryFor(hours: 1, minutes: 30)]`. Атрибут працює на завданнях, поставлених у чергу листах, сповіщеннях і слухачах, і успадковується від батьківського класу. Тож для групи вебхуків вікно можна задати один раз на абстрактному `WebhookJob`.

Найкорисніше поєднання - з `#[Backoff]`: повторювати із зростаючою затримкою, але не довше, ніж має сенс.

```php
#[Backoff(60, 300, 600)]
#[RetryFor(hours: 4)]
class ImportProducts implements ShouldQueue
{
  //
}
```

Наявний код поведінки не змінює: метод `retryUntil()` або властивість `$retryUntil` мають пріоритет над атрибутом. А `queue:retry` перераховує вікно для завдань з атрибутом так само, як уже робив це для `retryUntil()`.

### releaseUsingBackoff() для завдань, що чекають

Затримка перед повтором досі застосовувалася лише тоді, коли завдання кидало виняток. Якщо ж воно саме поверталося в чергу через `release()`, як завдання, що опитує сторонній сервіс, затримку доводилося рахувати вручну. Типовий код на кшталт `$this->release($this->backoff()[$this->attempts() - 1])` до того ж ламається на четвертій спробі, коли масив із трьох значень закінчується.

Новий метод `releaseUsingBackoff()` у трейті `InteractsWithQueue` ([#62435](https://github.com/laravel/framework/pull/62435)) бере затримку з backoff самого завдання:

```php
#[Backoff(5, 15, 60, 300)]
class WaitForExport implements ShouldQueue
{
  public function handle(): void
  {
    if (! $this->export->isReady()) {
      return $this->releaseUsingBackoff();
    }

    $this->export->download();
  }
}
```

Правила ті самі, що у воркера після винятку: значення читаються з атрибута `#[Backoff]`, властивості `$backoff` або методу `backoff()`, а коли спроб більше, ніж значень, повторюється останнє. Одна відмінність: якщо backoff у завдання не задано, воно повертається в чергу без затримки, бо опція воркера `--backoff` усередині завдання недоступна. Для завдань, що опитують API, це важливо: без `#[Backoff]` вони будуть крутитися без паузи, тож задавайте її явно і обмежуйте `#[Tries]` або `#[RetryFor]`.

### Predis повторює безпечні команди після обриву з'єднання

Воркери черги й Octane тримають з'єднання з Redis годинами. Якщо Redis стоїть за балансувальником, як AWS ElastiCache Serverless, той може тихо закрити з'єднання, і наступна команда падає з `ConnectionException` («Stream is already at the end»). Для PhpRedis Laravel уже вміє в такому разі перепідключитися і повторити команду, тепер те саме робить і Predis ([#62406](https://github.com/laravel/framework/pull/62406)).

Повторюється не все, а лише команди зі списку `RETRYABLE_COMMANDS`, який тепер живе в базовому класі `Connection` і спільний для обох клієнтів:

- читання: `get`, `mget`, `exists`, `ttl`, `hget`, `hgetall`, `lrange`, `smembers`, `zrange`, `zscore` та інші;
- записи, повтор яких дає той самий результат: `mset`, `hmset` і `set` без додаткових параметрів;
- `del`, доданий окремим PR ([#62502](https://github.com/laravel/framework/pull/62502)) після того, як у автора `Cache::delete()` валив завдання на продакшні.

Логіка відбору проста: команду можна повторити, якщо неважливо, чи дійшла до Redis перша спроба. Для `del` так і є: якщо перша спроба не дійшла, повтор видалить ключ, якщо дійшла - ключа вже немає. А от `incr` чи `lpush`, якщо перша спроба виконалася і загубилася лише відповідь, при повторі збільшать лічильник удруге або додадуть елемент двічі. Те саме з `set` з параметрами на кшталт `NX`: повтор після успішної першої спроби повернув би «не записано», тому `set` з третім аргументом зі списку виключено. Конвеєри й транзакції не повторюються ніколи, бо могли виконатися частково.

За замовчуванням робиться одна повторна спроба. Опція підключення `command_retries` збільшує кількість, але зверніть увагу: судячи з коду, вона застосовується до будь-якої команди, крім конвеєрів і транзакцій, а не лише до безпечних. Вмикайте її, лише якщо готові до подвійних записів.

### JsonSchema::rules(): одна схема замість двох описів

Кожен інструмент у laravel/ai і laravel/mcp оголошує JSON-схему для моделі, а потім повторює ті самі обмеження як правила валідації. Дві копії розходяться. `JsonSchema::rules()` ([#62355](https://github.com/laravel/framework/pull/62355)) перетворює схему об'єкта на звичайні правила Laravel:

```php
use Illuminate\JsonSchema\JsonSchema;

$schema = JsonSchema::object(fn ($s) => [
  'name' => $s->string()->max(50)->required(),
  'role' => $s->string()->enum(['admin', 'user'])->required(),
]);

JsonSchema::rules($schema);
// [
//     'name' => ['required', 'string', 'max:50'],
//     'role' => ['required', 'string', Rule::in(['admin', 'user'])],
// ]
```

Метод приймає і сирий масив схеми, наприклад схему MCP-інструмента, а результат можна передати у `Validator::make()` чи `rules()` запиту форми. Підтримуються `type`, `required`, `enum`, `anyOf`, вкладені `properties` та `items` (через ключі `address.city`, `tags.*`), обмеження довжини й діапазону, `pattern`, кілька форматів (`email`, `uri`, `uuid`, `date`, `date-time`), а з [#62496](https://github.com/laravel/framework/pull/62496) ще й `exclusiveMinimum` і `exclusiveMaximum`. Пам'ятайте, що це правила Laravel, а не валідатор JSON Schema: звичне приведення типів лишається, і рядок `"3"` пройде `integer`.

### Що ще в релізі

- **`RawTemplate`** для інлайн-компонентів Blade ([#62419](https://github.com/laravel/framework/pull/62419)). Рядок, який повертає `render()`, Blade компілює як шаблон, тож ім'я користувача з `{{ exec('whoami') }}` всередині виконається. Повертайте `new RawTemplate(...)`, щоб такий код був помітним; автор PR планує в 14.x залишити за рядками з `render()` лише назви view.
- **`isBlank()` і `isNotBlank()`** у `Stringable` ([#62415](https://github.com/laravel/framework/pull/62415)): `str($bio)->stripTags()->isBlank()` замість `blank(...)` навколо ланцюжка.
- **`DB::withoutAffectingStickiness()`** ([#62465](https://github.com/laravel/framework/pull/62465)): запис усередині колбека не прив'язує подальші читання до write-підключення при ввімкненому `sticky`. Зручно, коли завдання лише позначає `started_at`, а далі тільки читає. Ширше про те, як стежити за відставанням реплік, ми писали в розборі [Commit ID у Laravel 13.40](https://laravelukraine.com/blog/commit-id-u-laravel-1340-iak-diznatisia-shho-replika-vze-nazdognala-primary).
- **Конвеєризовані читання тегованого кешу Redis** ([#62451](https://github.com/laravel/framework/pull/62451)): `many()` на восьми ключах робить один запит до Redis замість восьми, тегований `flexible()` - один замість двох.
- **Кешування рефлексії моделей** ([#62432](https://github.com/laravel/framework/pull/62432)) прибирає частину сповільнення гідрації порівняно з Laravel 12, на яке скаржилися власники проєктів з великою кількістю трейтів і жадібного завантаження.

Реліз також містить виправлення безпеки, про них ми напишемо окремо.

### Чи варто оновлюватися

Так, і не відкладаючи - насамперед через виправлення безпеки. Перед `composer update` перевірте версію Horizon: laravel/horizon старіший за 5.47.0 тепер позначений як несумісний ([#62449](https://github.com/laravel/framework/pull/62449)), тож його доведеться оновити разом із фреймворком.

Нові API опційні й наявного коду не ламають. Після оновлення варто пройтися по завданнях: `retryUntil()` з фіксованим `now()->add...()` можна замінити на `#[RetryFor]`, а ручний розрахунок затримки перед `release()` - на `releaseUsingBackoff()`. Якщо ви на Predis і бачили в логах `Stream is already at the end` від воркерів, ця помилка для читань і безпечних записів має зникнути сама; для решти команд краще й далі покладатися на повтори самого завдання, ніж на `command_retries`.
