✨ Symfony 8.2: контроллер, который не запустится дважды одновременно
Некоторые действия нельзя запускать параллельно: импорт каталога, оплату заказа, продажу последних билетов. Раньше блокировку через компонент Lock приходилось брать и снимать вручную прямо в контроллере.
В Symfony 8.2 хватит атрибута #[Lock]. Пока запрос выполняется, второй с тем же ключом получит 409 Conflict, а с blocking: true подождёт. Ключ можно собрать из параметра маршрута, тогда у каждой конференции своя блокировка:
#[Route('/conference/{conference}/tickets', methods: 'POST')]
#[Lock('ticket-sale-{conference}', blocking: true, ttl: 10)]
public function buyTicket(Conference $conference): Response { /* ... */ }
Подвох в TTL: по умолчанию блокировка живёт 30 секунд и сама не продлевается. Если контроллер работает дольше, её захватит другой запрос.
Продлить её или отпустить раньше можно, если принять LockInterface аргументом контроллера.
🧩 Исключение, которое само объясняет, что сломалось
Обычно ошибку бизнес-логики бросают как InvalidArgumentException с текстом. Это работает, пока не понадобится поймать именно её. Тот же класс летит ещё из десятка мест.
В Spatie, где пишут хелпдеск There There на Laravel, заводят свой класс на каждую доменную ошибку. На каждую причину в нём есть статический метод. Код читается как фраза:
Метод принимает типизированный $message. Поэтому текст ошибки без id и типа сообщения просто не собрать.
Одна тонкость: такие классы помечают интерфейсом ShouldntReport, и они не попадают в трекер ошибок. Это ожидаемые ситуации от действий пользователя, а не баги, так что трекер не засоряется.
Выглядит как оверинжиниринг ровно до первого раза, когда нужно поймать конкретную ошибку.
Если бэкенд на Laravel, а фронтенд на TypeScript, каждый ответ сервера описан дважды. Переименовали поле в PHP, а фронт об этом не знает.
В Spatie, авторах пакетов ниже, такие типы руками не пишут. Ответ описывают PHP-классом из пакета spatie/laravel-data с атрибутом #[TypeScript]. Пакет spatie/laravel-typescript-transformer собирает эти классы в файл generated.d.ts: ?string становится string | null, у enum появляется свой тип.
Теперь после переименования свойства в PHP компилятор TypeScript подсвечивает каждое место на фронте, где оно используется.
Сам по себе файл не обновляется, его пишет php artisan typescript:transform. В версии 2.6 у команды нет --watch, поэтому Spatie запускают её из своего небольшого плагина для Vite. В v3 режим --watch уже встроен.
Проект «Terminal» стал крупнейшей библиотекой бесплатного образования. В одном канале собраны курсы, книги, полезные инструменты и практические тренажёры для всех разработчиков:
• Практические курсы и задания
• Книги и статьи известных авторов
• Полезные инструменты и ресурсы
• IT-новости и инсайды
Обучение по всем направлениям: SQL, Python, ML, Frontend, PHP, C++, Go, Git, Linux, QA, Java, Vibe-coding, InfoSec и др.