Увійти Реєстрація
Вакансії
Вакансії Laravel Компанії Статистика
Підготовка
Як підготуватися Співбесіди Тестування Документація
Блог
Всі статті Серії
Екосистема
Пакети Ресурси Проєкти Інструменти Події Відео
Інше
Про нас Реклама
Reservable-моделі в Laravel: як уникнути дублювання обробки за допомогою атомарних блокувань
Новини 05 жовтня 2026

Reservable-моделі в Laravel: як уникнути дублювання обробки за допомогою атомарних блокувань

Під час перебудови свого персонального сайту Аарон Френсіс працює з багатьма сторонніми сервісами: завантажує відео з YouTube, транскрибує аудіо, просить OpenAI зробити підсумки транскриптів тощо. У статті він ділиться підходом, який назвав «резервованими моделями».

Вихідна ситуація: scopes та команди

Автор активно використовує Eloquent scopes, щоб визначити, що саме потрібно зробити. Ось кілька scopes із моделі Video:

public function scopeReadyForDownload(Builder $query): void
{
    $query->whereNull('video_path');
}

public function scopeReadyForAudio(Builder $query): void
{
    $query->whereNotNull('video_path')->whereNull('audio_path');
}

public function scopeReadyForTranscript(Builder $query): void
{
    $query->whereNotNull('audio_path')->whereDoesntHave('transcripts');
}

public function scopeReadyForThumbnails(Builder $query): void
{
    $query->whereNotNull('video_path')->whereNull('thumbnails');
}

Для кожного завдання існує окрема команда, яка бере моделі й виконує роботу. Ось команда Download:

class Download extends Command
{
    protected $signature = 'youtube:download';

    protected $description = 'Download YouTube videos and put them on S3.';

    public function handle(): void
    {
        Video::readyForDownload()->each(function (Video $video) {
            Log::info('Downloading ' . $video->title);
            // Do something interesting
        });
    }
}

Дві проблеми нерезервованого підходу

Перша проблема: залежно від тривалості виконання команди, частоти її запуску та інших реальних чинників модель може пройти через воркфлоу більше одного разу. Можна додати withoutOverlapping у розкладі (автор це рекомендує), але хтось усе одно може запустити команду вручну, і обробки перетнуться.

Друга проблема стосується не дублювання, а «стовпотворіння» при збоях. Якщо команда запускається щохвилини і одне конкретне відео постійно падає, можна спробувати завантажити його з YouTube 60 разів на годину, що навряд чи сподобається YouTube. Потрібен своєрідний бар'єр, який не дасть постійно навантажувати зовнішні ресурси при повторних помилках.

Резервування моделей через кеш-блокування

Замість домовленостей у команді автор пропонує вирішити проблему раз і назавжди через cache locks. У Laravel є надійний механізм атомарних блокувань, який працює з різними драйверами, зокрема з драйвером бази даних. Про атомарні блокування в Laravel також є відео автора: Laravel solved race conditions.

Атомарні блокування гарантують, що лише один процес утримує lock. Але замість прямої роботи з блокуванням автор звертається до нього через модель, адже мета - резервувати саме моделі. Для цього створюється трейт Reservable з двома методами:

trait Reservable
{
    public function reserve(mixed $key, string|int|Carbon $duration = 60): bool
    {
        //
    }

    public function release(mixed $key): void
    {
        //
    }
}

Використання виглядає так:

$reserved = $video->reserve('download', '+1 hour');

Розробнику не потрібно думати про деталі кеш-системи: він просто намагається зарезервувати модель для певної цілі та отримує відповідь «так» або «ні».

Метод reservation

Основна логіка живе в методі reservation, який повертає екземпляр Illuminate\Contracts\Cache\Lock:

public function reservation(mixed $key, string|int|Carbon $duration = 60): Lock
{
    // Convert e.g. +6 hours to a Carbon instance
    if (is_string($duration)) {
        $duration = Carbon::make($duration);
    }

    // Convert Carbon to seconds from now
    if ($duration instanceof Carbon) {
        $duration = max(0, $duration->diffInSeconds(now()));
    }

    // Convert enums to strings
    if ($key instanceof UnitEnum) {
        $key = $key->name;
    }

    // Convert objects to strings
    if (is_object($key)) {
        $key = get_class($key);
    }

    // Use the most stable methods of representing a model.
    return Cache::lock(
        "{$this->getMorphClass()}:{$this->getKey()}:{$key}", $duration
    );
}

Інтерфейс вийшов гнучким: як $key можна передати майже будь-що, а як $duration - рядок, число секунд або Carbon. Автор пояснює, навіщо це, далі в статті.

Завершена реалізація

public function reserve(mixed $key, string|int|Carbon $duration = 60): bool
{
    return $this->reservation($key, $duration)->get();
}

public function release(mixed $key): void
{
    $this->reservation($key)->forceRelease();
}

У reserve створюється lock і виконується спроба його get, що повертає булеве значення успіху чи невдачі. У release lock створюється і звільняється через forceRelease. Тут потрібен саме forceRelease, бо поточний код не є власником блокування: $owner не передавався, тож він має випадкове значення. Зазвичай чужі блокування звільняти не варто, тому цей метод слід використовувати, лише чітко розуміючи навіщо. У цьому випадку це виправдано, бо блокування дуже вузько обмежені за призначенням.

Використання трейта Reservable

Тепер трейт легко додати до команди Download:

class Download extends Command
{
    protected $signature = 'youtube:download';

    protected $description = 'Download YouTube videos and put them on S3.';

    public function handle(): void
    {
        $video = Video::query()
            ->readyForDownload()
            ->get()
            // Get the first one that can be reserved for this command, for 6 hours.
            ->first(fn(Video $video) => $video->reserve($this, '+6 hours'));

        if (!$video) {
            return;
        }

        Log::info('Downloading ' . $video->title);
        // Do something interesting
    }
}

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

video:249:App\Console\Commands\YouTube\Download

Звільняти блокування не потрібно - його можна просто залишити до завершення терміну дії. Якщо команда виконалась успішно, блокування вже неважливе: відео не треба завантажувати знову, а scope виключить його з вибірки. Якщо ж команда впала, модель має лишатися заблокованою на 6 годин, щоб запобігти безперервним помилкам.

Макроси

Рядок із first(...) можна зробити охайнішим за допомогою макросу для Eloquent Collection:

Collection::macro('firstReserved', function (mixed $key, string|int|Carbon $duration = 60) {
    return $this->first(fn($item) => $item->reserve($key, $duration));
});

Тоді команда виглядає так:

class Download extends Command
{
    public function handle(): void
    {
        $video = Video::readyForDownload()->get()->firstReserved($this, '+6 hours');

        if (!$video) {
            return;
        }

        Log::info('Downloading ' . $video->title);
        // Do something interesting
    }
}

Макрос можна додати навіть до Builder:

Builder::macro('firstReserved', function (mixed $key, string|int|Carbon $duration = 60) {
    return $this->get()->first(fn($item) => $item->reserve($key, $duration));
});

Тоді зайвий виклик get посередині не потрібен:

class Download extends Command
{
    public function handle(): void
    {
        $video = Video::readyForDownload()->firstReserved($this, '+6 hours');

        if (!$video) {
            return;
        }

        Log::info('Downloading ' . $video->title);
        // Do something interesting
    }
}

Автор нещодавно почав користувати цей підхід і вважає його зручним, але запрошує читачів ділитися ідеями щодо покращень - зворотний зв'язок можна залишити у його акаунті в Twitter.

16

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

Коментарі

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

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

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

Laravel 13.43
Новини 19 листопада 2026

Laravel 13.43 і 12.73: серія виправлень безпеки, від масового присвоєння до підписаних URL

Laravel 13.43.0 і 12.73.0 закривають обхід захисту масового присвоєння через мутатори, ще одну дірку в терміні дії підписаних URL, DoS у JsonSchema і XSS на debug-сторінці. Кілька правил валідації exists, unique і not_regex після оновлення можуть поводитися суворіше.

20
Laravel 13.43
Новини 19 листопада 2026

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

Laravel 13.43.0 додає атрибут #[RetryFor] замість методу retryUntil() і releaseUsingBackoff() для завдань, що самі повертаються в чергу. Predis тепер повторює безпечні команди після втрати з'єднання, а JsonSchema::rules() виводить правила валідації прямо зі схеми.

13

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

halsoft.net Нова
2 дні тому

Shopify Apps Developer

Розробка веб-застосунків і Shopify-застосунків для власників магазинів Shopify: бекенд-сервіси на PHP Laravel, фронтенд на React, інтеграція з магазинами Shopify, RESTful API та код-ревʼю. Вимоги: досвід Shopify-застосунків, знання Node.js, Laravel, ReactJS, Vue.js, HTML, CSS, JavaScript, Git і портфоліо проєктів. На старті роботa на неповну ставку.

Starlight Media Нова
2 дні тому

Senior Full-Stack Developer (PHP / Go / Vue.js)

Senior Full-Stack розробник матиме розвивати й підтримувати існуючі веб-платформи, писати модулі, сервіси та API, а також розробляти клієнтську частину на Vue.js і Vanilla JS. Основний стек: PHP 8.x з Yii2 та/або Laravel, Go для сервісів, MySQL/MariaDB, REST API і Webhooks. Вимоги: досвід від 3 років, знання ООП і шаблонів проєктування, ES6+, Vue.js, SPA, Git, Docker і Composer; англійська B1-B2.

Анатол, ТзОВ
12 днів тому

Web developer (PHP)

Розробка та підтримка функціоналу CRM-системи, розробка й вдосконалення вебсайтів, інтеграція сторонніх сервісів через API та оптимізація продуктивності сайтів і баз даних. Вимоги: досвід від 1 року, впевнене знання HTML, CSS3 (SCSS), PHP 7.4, JavaScript, jQuery, AJAX, досвід роботи з Laravel, MySQL, розуміння базових принципів SEO та адаптивної верстки.

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

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