Умовне завершення чергових задач з обмеженням виключень у Laravel 12.20

Перекладено ШІ 1 Laravel News 02 червня, 2026

Ознайомтеся з новими можливостями Laravel v12.20.0, які відкривають ширші горизонти для розробників: від покращення методів для роботи з рядками до впровадження нових функцій у черги. Долучайтеся до читання, щоб дізнатися, як ці оновлення можуть спростити вашу роботу

Команда Laravel випустила версію v12.20.0, яка містить нові можливості, зокрема: обробку помилок під час обмеження викликів, метод fakeFor у фасаді Queue, метод Context::remember(), а також можливість налаштування pluck() у колекціях за допомогою колбеків та інше:

# Запам'ятовування Контексту

Ben Askew додав функції remember() та rememberHidden(), які зберігають результат наданої замикальної функції у контексті, якщо він ще не доданий, і завжди повертають цей результат:

// До
if (Context::has('user-permissions')) {
    $permissions = Context::get('user-permissions');
} else {
    $permissions = auth()->user()->permissions;
    Context::set('user-permissions', $permissions);
}

// Після
$permissions = Context::remember('user-permissions', fn() => auth()->user()->permissions);

Деталі у Pull Request #56156.

# Методи "Не починається/Не закінчується з" для рядків

Balboa Codes додав методи doesntStartWith() та doesntEndWith() до класів Str та Stringable, які є протилежними startsWith() та endsWith(). Ви можете порівнювати значення з іншим рядком або масивом рядків:

use Illuminate\Support\Str;

Str::doesntEndWith('Це моє ім’я', 'пес'); // true
Str::doesntEndWith('Це моє ім’я', ['ім’я', 'foo']); // false

Str::doesntStartWith('Це моє ім’я', 'Те'); // true
Str::doesntStartWith('Це моє ім’я', ['Це', 'Те', 'Там']); // false

Деталі у Pull Request #56168 та в документації Strings.

# Додавання методу failWhen() до middleware ThrottlesExceptions

Michael Dzjaparidze додав метод failWhen() до middleware ThrottlesExceptions:

Цей middleware зараз дозволяє видаляти завдання лише при виникненні певного виключення. Іноді потрібно позначити завдання як невдале. Наприклад, під час виконання ланцюга завдань бажано зупинити виконання при виникненні виключення.

Ось приклад:

public function middleware(): array
{
    return [
        (new ThrottlesExceptions(2, 10 * 60))
            ->deleteWhen(CustomerDeletedException::class)
            ->failWhen(fn (\Throwable $e) => /* ... */)
    ];
}

Деталі у Pull Request #56180. Додаткову інформацію можна знайти в документації Queues.

# Додавання методів fakeFor() та fakeExceptFor() до фасаду Queue

Punyapal Shah додав нові методи до фасаду Queue, які слідують тому ж шаблону, що і фасад Event:

// До: Фейк впливає на весь тест
Queue::fake();
// ... тестовий код ...
// Необхідно вручну очищати

// Після: Фейк обмежений
Queue::fakeFor(function () {
    Queue::push(new ProcessPayment);
    Queue::assertPushed(ProcessPayment::class);
}); // Оригінальна черга автоматично відновлена

// Вибірковий фейк завдань
// Дозволити критичним завданням ставитися до черги без обмежень, фейкувати інші
Queue::fakeExceptFor(function () {
    Queue::push(new CriticalSystemJob);  // Дійсно додано до черги
    Queue::push(new EmailNotification);  // Фейк

    Queue::assertNotPushed(CriticalSystemJob::class);
    Queue::assertPushed(EmailNotification::class);
}, [CriticalSystemJob::class]);

Деталі у Pull Request #56149.

# Додавання інтерфейсу JsonSerializable до класу Uri

@devajmeireles додав інтерфейс JsonSerializable, щоб забезпечити правильне перетворення класу Uri на JSON:

// Приклад
Route::get('/testing', function () {
    return User::first()->only('id', 'url');
});

/* До {"id": 1, "url": {}} */

/* Після {"id": 1, "url": "https://sanford.biz/..."} */

Деталі у Pull Request #56097.

# Зробити клас Fluent ітерованим

Volodya Kurshudyan представив контракт Iterable для класу Fluent, що вирішує невелику проблему при використанні Fluent в циклах:

// Необхідно викликати toArray() для ітерації
foreach ($user->settings->toArray() as $key => $value) {
    //
}

// Тепер властивість `settings` ітерується в Laravel 12.20
foreach ($user->settings as $key => $value) {
    //
}

Деталі у Pull Request #56218.

# Додавання методу collection() до репозиторію конфігурацій

Kennedy Tedesco додав метод collection(), який повертає екземпляр колекції з репозиторію конфігурацій:

// До
collect(Config::array('my_file.my_key'));

// Після
Config::collection('my_file.my_key');

Деталі у Pull Request #56200.

# Додавання підтримки Closure до методу pluck() колекцій

Ralph J. Smit оновив метод pluck(), щоб дозволити налаштування ключів та значень:

Цей PR додає підтримку замикань для параметрів $key/$value методів pluck(). Часто я майже можу використовувати pluck(), але потребую незначної модифікації ключа або значення. Я повинен вирішувати це за допомогою mapWithKeys(), але це повторює id й робить код занадто обтяжливим, коли потрібно тільки застосувати форматування.

Тепер ви можете робити ось так:

Country::get()
    ->pluck(fn (Country $country) => "{$country->flag} {$country->name}", 'id');

Деталі у Pull Request #56188.

# Директива Blade для перевірки контексту

Martin Bean додав директиву @context для визначення, чи існує значення в контексті:

@context('canonical')
    
@endcontext

Деталі у Pull Request #56146.

# Примітки до випуску

Ви можете переглянути повний список нових функцій та оновлень нижче, а також порівняти різницю між 12.19.0 та 12.20.0 на GitHub. Нижче наведені примітки до випуску, безпосередньо з чэнджлогу:

# v12.20.0

Популярні

Інше, що варто прочитати

173 Оновлено 01 червня, 2026

Використання повнотекстового пошуку в Laravel

Laravel пропонує потужні можливості повнотекстового пошуку за допомогою методів whereFullText та orWhereFullText, що дозволяють здійснювати складні запити до бази даних. Дізнайтеся, як реалізувати ефективний пошук для вашого блогу чи системи управління контентом

2026 ЧИТАТИ
15 Оновлено 01 червня, 2026

Intervention Image: потужний інструмент для роботи з зображеннями у Laravel

Досліджуйте потужний пакет Intervention Image для PHP, який виводить редагування зображень на новий рівень з оновленою версією 3. Чи готові ви дізнатися, які нові можливості та функції чекають на вас у цьому інструменті

2026 ЧИТАТИ
11 Оновлено 01 червня, 2026

Управління доступом у Filament за допомогою плагіна Shield

Дізнайтеся, як пакет Filament Shield забезпечує управління доступом до ваших панелей, ресурсів і віджетів у Laravel. Ця стаття розкриває основні можливості пакету, включаючи просту установку та підтримку багатокористувацьких середовищ — не пропустіть!

2026 ЧИТАТИ