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.