Увійти Реєстрація
Вакансії
Вакансії Laravel Компанії Статистика
Підготовка
Як підготуватися Співбесіди Тестування Документація
Блог
Всі статті Серії
Екосистема
Пакети Ресурси Проєкти Інструменти Події Відео
Інше
Про нас Реклама
Новини 19 листопада 2026

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

Laravel 13.43.0 вийшов 17 листопада, і найпомітніше в ньому стосується черг: дві зміни прибирають код, який досі доводилося писати руками в кожному другому завданні, а третя закриває давню проблему довгоживучих воркерів і Octane, що працюють з Redis через Predis за балансувальником. Поруч - правила валідації, виведені прямо з JSON-схеми, і кілька дрібніших API.

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

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

// Раніше
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]: повторювати із зростаючою затримкою, але не довше, ніж має сенс.

#[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) бере затримку з backoff самого завдання:

#[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).

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

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

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

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

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

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

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 ще й exclusiveMinimum і exclusiveMaximum. Пам'ятайте, що це правила Laravel, а не валідатор JSON Schema: звичне приведення типів лишається, і рядок "3" пройде integer.

Що ще в релізі

  • RawTemplate для інлайн-компонентів Blade (#62419). Рядок, який повертає render(), Blade компілює як шаблон, тож ім'я користувача з {{ exec('whoami') }} всередині виконається. Повертайте new RawTemplate(...), щоб такий код був помітним; автор PR планує в 14.x залишити за рядками з render() лише назви view.
  • isBlank() і isNotBlank() у Stringable (#62415): str($bio)->stripTags()->isBlank() замість blank(...) навколо ланцюжка.
  • DB::withoutAffectingStickiness() (#62465): запис усередині колбека не прив'язує подальші читання до write-підключення при ввімкненому sticky. Зручно, коли завдання лише позначає started_at, а далі тільки читає. Ширше про те, як стежити за відставанням реплік, ми писали в розборі Commit ID у Laravel 13.40.
  • Конвеєризовані читання тегованого кешу Redis (#62451): many() на восьми ключах робить один запит до Redis замість восьми, тегований flexible() - один замість двох.
  • Кешування рефлексії моделей (#62432) прибирає частину сповільнення гідрації порівняно з Laravel 12, на яке скаржилися власники проєктів з великою кількістю трейтів і жадібного завантаження.

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

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

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

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

0

Читати в документації

Коментарі

Увійдіть, щоб залишити коментар

Будьте першим, хто залишить коментар!

Читайте також

PHP 8.6: день релізу і що він означає для Laravel
Новини 19 листопада 2026

PHP 8.6: день релізу і що він означає для Laravel

19 листопада - день релізу PHP 8.6: часткове застосування функцій, клас Time\Duration, Io\Poll API, clamp(), енум SortDirection і значення за замовчуванням для readonly-властивостей. Розбираємо, що змінилося з часу наших оглядів, які зміни поведінки легко проґавити і коли Laravel-проєктам варто оновлюватися.

Durable Workflow
Новини 19 листопада 2026

Durable Workflow: довгі фонові процеси в Laravel, які переживають падіння воркера

Durable Workflow (колишній Laravel Workflow) Річарда Макденіела записує результат кожного кроку фонового процесу в історію і після падіння воркера продовжує з того місця, де зупинився. Розбираємо ідею workflow й activity, вимоги до черги й кешу, правило детермінованості та сигнали. Свіжий реліз - 2.29.0.

12

Вакансії за темою

FAVBET Нова
Вчора

PHP Tech Lead

Технічний лідер PHP-команди з ownership над ключовими сервісами: інтеграціями, обробкою транзакцій і сегментацією користувачів. Проєктує сервіси, веде SDD і TIP, робить code review, менторить розробників і впроваджує AI-assisted розробку. Вимоги: 6+ років досвіду на Symfony або Laravel, 2+ роки на ролі Tech Lead, глибоке знання PHP 8+ і Symfony, PostgreSQL, Redis, RabbitMQ, Docker/Kubernetes.

Corefy Нова
Вчора

PHP Developer — Integrations

Розробка та підключення нових платіжних провайдерів і методів: від аналізу документації до продакшну, а також рефакторинг, закриття технічного боргу та створення внутрішніх інструментів для команди. Основний стек: PHP 8.3, Symfony, PostgreSQL/MySQL, Kafka, Redis, Docker, AWS SQS. Вимоги: 1.5-3+ роки комерційного досвіду на PHP, досвід Symfony 5/6 або Laravel, знання баз даних, RESTful API та покриття коду тестами PHPUnit.

Corefy Нова
2 дні тому

Senior PHP Developer

Потрібен Senior PHP Developer, який самостійно веде складні фічі end-to-end: від проєктування рішення та плану впровадження до релізу й підтримки в продакшні. Основний стек: PHP 8+, Symfony 6+, PostgreSQL, Kafka, Redis, ClickHouse, RoadRunner, Docker, Kubernetes у мікросервісній архітектурі. Вимоги: 5+ років комерційного досвіду з PHP, 3+ роки з Symfony або Laravel, досвід мікросервісів і RESTful API, тестування (PHPUnit), Docker та CI/CD. Очікуються code review, архітектурні обговорення та мент

Пакети за темою

Kalimera

welldigit/kalimera

Interactive installer that scaffolds Laravel applications the Well Digit way.

v1.0.0 17

Bagisto

bagisto/bagisto

Bagisto — це платформа для електронної комерції, побудована на Laravel. Вона надає готове рішення для створення та управління інтернет-магазинами з підтримкою каталогу товарів, замовлень, платежів та клієнтів.

28,384 v2.5.2 13 28