Песимістичне блокування в Laravel Eloquent з методом refreshForUpdate()

Eloquent вже давно має метод refresh() для перезавантаження моделі з бази даних та lockForUpdate() для встановлення блокування рядка як частини запиту. Чого не було раніше - це можливості виконати обидві операції одночасно для екземпляра моделі. Laravel 13.27 додає метод refreshForUpdate(), який був внесений @stevebauman у pull request #61247.

Що робить новий метод

Метод refreshForUpdate() перезавантажує модель за її первинним ключем із застосуванням FOR UPDATE та оновлює екземпляр на місці:

public function refreshForUpdate()
{
    if (! $this->exists) {
        return $this;
    }
    
    return $this->refreshUsingQuery(
        $this->newQueryWithoutScopes()->lockForUpdate()
    );
}

Метод refreshUsingQuery() - це той самий допоміжний метод, що використовується за лаштунками refresh(). Він обмежує запит до ключа моделі, пропускає його через useWritePdo(), щоб репліка для читання не могла обслужити блокування, на яке ви збираєтеся покладатися, викликає firstOrFail(), замінює сирі атрибути, перезавантажує будь-які зв'язки, які вже були завантажені, та синхронізує початковий стан атрибутів. Єдине, що додає refreshForUpdate() - це блокування.

Порівняння підходів

До появи методу refreshForUpdate() безпечне зменшення запасів продукту виглядало б так:

public function purchase(Product $product): Response
{
    DB::transaction(function () use ($product) {
        $product = Product::query()
            ->lockForUpdate()
            ->findOrFail($product->getKey());
            
        if ($product->stock === 0) {
            throw new RuntimeException('The product is out of stock.');
        }
        
        $product->decrement('stock');
    });
    // ...
}

Тепер ви можете перезавантажити та заблокувати модель безпосередньо за допомогою refreshForUpdate():

public function purchase(Product $product): Response
{
    DB::transaction(function () use ($product) {
        $product->refreshForUpdate();
        
        if ($product->stock === 0) {
            throw new RuntimeException('The product is out of stock.');
        }
        
        $product->decrement('stock');
    });
    // ...
}

Переваги нового підходу

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

Метод автоматично обробляє всі важливі деталі: використовує з'єднання для запису (а не репліку для читання), перезавантажує всі попередньо завантажені зв'язки та синхронізує стан атрибутів. Це робить песимістичне блокування простішим у використанні та менш схильним до помилок.

Додаткові матеріали

Для глибшого розуміння теми песимістичного блокування та управління гонками даних у Laravel рекомендується ознайомитися з:

• Повним оглядом Laravel 13.27 та методу refreshForUpdate()
• Статтею про управління гонками даних за допомогою песимістичного блокування в Laravel
• Матеріалом про виявлення та виправлення умов гонки в Laravel-додатках
• Інформацією про запобігання умовам гонки за допомогою атомарних блокувань кешу