Laravel 13.5.0 отримав повноцінну підтримку Redis Cluster для роботи з чергами.

Laravel v13.5.0 додає повноцінну підтримку Redis Cluster для драйвера черг та обмежувача паралельності (concurrency limiter). Це розв'язує проблему з помилками CROSSSLOT в AWS ElastiCache Serverless та інших конфігураціях Redis Cluster. Також у релізі: атрибут #[Delay] для Mailables, успадкування Middleware в контролерах, розширена підтримка Enum у менеджерах та низка виправлень.

• Повноцінна підтримка Redis Cluster для черг та ConcurrencyLimiter
• Атрибут #[Delay] тепер працює для поштових повідомлень (mailables) у черзі
• Атрибути Controller Middleware успадковуються дочірніми контролерами
• Розширена підтримка Enum у Cache, Mail, Auth та інших менеджерах
• Підтримка Closure у методах updateOrCreate та firstOrNew
• Новий хук Cache::handleUnserializableClassUsing() для виявлення пошкоджених значень у кеші
• Виправлення для завдань ShouldBeUniqueUntilProcessing, які вивільняли чужі замки (locks)

# Що нового

# Повноцінна підтримка Redis Cluster для черг та ConcurrencyLimiter

Раніше при використанні AWS ElastiCache Serverless (Valkey) або будь-якого Redis Cluster черги Laravel та ConcurrencyLimiter могли видавати помилки CROSSSLOT. Lua-скрипти черг працюють із кількома ключами — queues:default, queues:default:reserved та queues:default:notify. Оскільки вони потрапляли у різні слоти кластера, Redis Cluster забороняв виконання такої операції в межах однієї команди.

Тепер Laravel автоматично обгортає назви черг у хеш-теги Redis, якщо використовується кластерне з’єднання. Це гарантує, що всі пов’язані ключі потраплять в один слот:

queues:{default}           → слот для "default"
queues:{default}:delayed   → слот для "default"
queues:{default}:reserved  → слот для "default"
queues:{default}:notify    → слот для "default"

Різні черги (наприклад, {emails} та {notifications}) продовжують природно розподілятися по кластеру. Публічний метод getQueue() залишився без змін, тому сторонні інтеграції бачать назви черг у звичному форматі. Для користувачів без кластерів нічого не змінилося.

Аналогічне рішення впроваджено для ConcurrencyLimiter — ключі тепер обгортаються у хеш-теги, що запобігає конфліктам слотів у Lua-скриптах.

Для phpredis 5.3.2+ конектор кластера отримав підтримку ACL-авторизації та нові опції: max_retries, backoff_algorithm, backoff_base та backoff_cap. Це покращує сумісність із динамічним масштабуванням ElastiCache Serverless.

Pull Request: #59533 від @timmylindh

# Підтримка атрибута #[Delay] для Mailables

Атрибут #[Delay], який з'явився у версії v13.4.0 для завдань та подій, тепер підтримується і в Mailables. Раніше поштові класи ігнорували цей атрибут, використовуючи лише властивість $delay.

use Illuminate\Queue\Attributes\Delay;
 
#[Delay(30)]
class WelcomeEmail extends Mailable implements ShouldQueue
{
    // Тепер коректно затримується на 30 секунд у черзі
}

Властивість $delay, як і раніше, має пріоритет, якщо вона встановлена явно.

Pull Request: #59580 від @sumaiazaman

# Успадкування атрибутів Controller Middleware

Атрибут #[Middleware] на базовому контролері тепер успадковується дочірніми класами. Раніше розробникам доводилося дублювати атрибути в кожному класі-нащадку.

use Illuminate\Routing\Attributes\Middleware;
 
#[Middleware('auth')]
#[Middleware('log:api')]
abstract class AdminBaseController extends Controller
{
    // Загальна логіка адмінки
}
 
class AdminController extends AdminBaseController
{
    public function index()
    {
        // Успадковує мідлвари 'auth' та 'log:api' від батька
    }
}

Pull Request: #59597 від @niduranga

# Розширена підтримка Enum у менеджерах

Підтримку Enum додано до кількох менеджерів, де її бракувало:

CacheManager — методи store(), driver(), memo(), forgetDriver(), purge() та setDefaultDriver() тепер приймають UnitEnum:

enum CacheStore: string
{
    case Redis = 'redis';
    case Array = 'array';
}
 
Cache::store(CacheStore::Redis)->put('key', 'value');

MailManager — методи mailer(), driver() та purge() підтримують Enum.

AuthManager — guard(), shouldUse() та setDefaultDriver() також отримали підтримку Enum.

Крім того, підтримка Enum з'явилася в базовому методі Manager::driver(), що поширює цей паттерн на всі класи, які від нього успадковуються.

Pull Requests: #59637, #59645, #59646, #59659

# Closure у методах updateOrCreate та firstOrNew

Методи updateOrCreate та firstOrNew тепер дозволяють передавати Closure як аргумент $values. Це завершує впровадження механізму «лінивих» обчислень для цих методів. Це корисно для виконання ресурсномістких операцій (наприклад, запитів до сторонніх API), які мають запускатися лише тоді, коли запис дійсно потрібно створити чи оновити.

$location = Location::updateOrCreate(
    ['address' => $address],
    fn () => ['coordinates' => Geocoder::resolve($address)],
);

Pull Request: #59647 від @yousefkadah

# Виявлення об'єктів у кеші, що не підлягають серіалізації

Новий хук Cache::handleUnserializableClassUsing() дозволяє зареєструвати callback, який спрацює, якщо значення з кешу десеріалізується як __PHP_Incomplete_Class. Це часто трапляється, коли використовується список дозволених класів (serializable_classes), але потрібний клас у ньому відсутній.

Cache::handleUnserializableClassUsing(function (string $key, ?string $class): void {
    if (app()->isProduction()) {
        Log::warning("Cache hit [{$key}] повернув клас, що не підлягає серіалізації: [{$class}]");
        return;
    }
 
    throw new RuntimeException("Помилка десеріалізації для ключа [{$key}], клас: [{$class}]");
});

Pull Request: #59630 від @jackbayliss

# Інші виправлення та покращення

Queue:

• Виправлено помилку, через яку повторні спроби завдань ShouldBeUniqueUntilProcessing вивільняли замки, які їм не належать.

Redis:

• Нормалізовано параметри контексту SSL у phpredis для одиночних та кластерних з'єднань.

Auth:

• Виправлено баг, коли redirectUsersTo() перезаписував callback redirectGuestsTo().
• Усунуто помилкове спрацьовування нечіткого порівняння в NotPwnedVerifier.

Testing:

• Результат TestCase::withoutBootingFramework() тепер кешується (memoization) для уникнення зайвих обчислень.

References

• Офіційний список змін
• Реліз на GitHub
• Повне порівняння коду