К основному содержанию
скилл CX Codex

doctrine-transactions — скилл для Claude Code: описание и установка

Скилл doctrine-transactions настраивает транзакции в Doctrine ORM 3, блокировки и границы сброса изменений в Symfony. Пригодится при параллельной правке строк и сбоях flush.

MIT ★ 234 обновлён 2026-10-05

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a claude-code
Открыть на GitHub

Что делает doctrine-transactions

Скилл учит агента выносить границы транзакций в сервисный слой вместо контроллеров и группировать изменения под один вызов wrapInTransaction(). В Doctrine ORM 3 метод transactional() удалён, поэтому код сразу строится вокруг нового API с одиночным flush().

В логику закладывается выбор блокировок: оптимистичная через атрибут #[ORM\Version] для правок пользователей или пессимистичная PESSIMISTIC_WRITE для критических участков. Внутри транзакций и пессимистичных блокировок нельзя делать HTTP-запросы или слать почту, чтобы не держать соединение с базой открытым.

После сбоя сохранения, нарушения ограничений или отката скилл требует очищать EntityManager через метод clear(). Повторно использовать сущности из упавшего UnitOfWork нельзя: их нужно запрашивать из базы заново.

Какие задачи решает

  • изолировать пачку связанных записей в БД через wrapInTransaction() в ORM 3
  • настроить оптимистичную блокировку с атрибутом #[ORM\Version] против конфликтов правки
  • защитить критические участки базы через пессимистичную блокировку PESSIMISTIC_WRITE
  • обработать сбой flush() и очистить EntityManager после отката

Примеры запросов агенту

  • Перепиши метод сохранения заказа на wrapInTransaction() и настрой один flush() в конце сервиса
  • Добавь версионирование #[ORM\Version] в сущность статьи и обработай OptimisticLockException
  • Защити списание баланса с помощью PESSIMISTIC_WRITE без внешних HTTP-вызовов внутри транзакции

Как установить doctrine-transactions

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a claude-code

2Вручную: положить файлы

~/.claude/skills/doctrine-transactions/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/doctrine-transactions/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о doctrine-transactions

Как установить doctrine-transactions в Claude Code?

Выполните команду npx skills add dev-toolings/superpowers-symfony --skill doctrine-transactions -a claude-code или сохраните файл по пути ~/.claude/skills/doctrine-transactions/SKILL.md.

Что делает скилл doctrine-transactions?

Он задаёт правила работы с транзакциями Doctrine в Symfony, требуя выносить границы в сервисы, применять wrapInTransaction() вместо устаревшего transactional() и сводить запись к одному flush().

Что делать с EntityManager при ошибке отката?

После отката транзакции или нарушения ограничений нужно очистить EntityManager и заново запросить нужные сущности из базы данных. Использовать объекты из упавшего блока работы запрещено.

Исходный текст

SKILL.md · MIT
---
name: doctrine-transactions
description: Handle Doctrine transactions (ORM 3 wrapInTransaction), optimistic/pessimistic locking, flush strategies, and transaction boundaries
capabilities: [read, search, edit, shell]
tags: [doctrine]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Doctrine Transactions (Symfony)

## Use when
- Several writes must succeed or fail together.
- Two users or workers can edit the same row concurrently.
- Deciding where to flush and who owns the transaction boundary.
- Recovering after a failed flush, a constraint violation, or a lost connection.

## Default workflow
1. Place the transaction boundary in the service layer, not in the controller.
2. Group related changes and flush once, inside `wrapInTransaction()`.
3. Pick the concurrency strategy: `#[ORM\Version]` optimistic locking for edits, `PESSIMISTIC_WRITE` for short critical sections.
4. Handle `OptimisticLockException` and constraint violations explicitly.
5. After a rollback, clear the EntityManager and re-fetch what you still need.

## Guardrails
- On ORM 3, `EntityManager::transactional()` is gone: use `wrapInTransaction()`.
- Outside an explicit transaction each flush commits on its own, so avoid several flushes per operation.
- Keep transactions and pessimistic locks short; no HTTP calls or mail inside.
- Do not reuse entities from a failed unit of work.

## Progressive disclosure
- Use this file for execution posture and risk controls.
- Open references when deep implementation details are needed.

## Output contract
- Transaction boundaries with a single flush per operation.
- The locking strategy chosen per entity, and how conflicts reach the user.
- Rollback handling and the state of the EntityManager after it.

## References
- `reference.md`

© dev-toolings · MIT · dev-toolings/superpowers-symfony

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо 512-frameworks-micronaut-data Juan Antonio Breña Moral Скилл 512-frameworks-micronaut-data для работы с репозиториями и сущностями Micronaut Data: маппинг, транзакции, пагинация, проекции и тесты на Testcontainers. CX Codex +1 322установок eloquent-best-practices iSerter Скилл eloquent-best-practices задаёт правила работы с Laravel Eloquent: от жадной загрузки связей до защиты от массового заполнения. Помогает писать быстрые выборки без проблемы N+1. CX Codex +1 1 300установок Pimcore Expert официальный github Субагент Pimcore Expert консультирует по архитектуре Pimcore 11+, настройке Symfony 6+ и PHP 8.2+. Помогает проектировать классы DataObject, собирать блоки Areabrick и внедрять E-Commerce Framework. CX Codex +1 ★ 41 430звёзд репо aws-lambda-php-integration giuseppe-trisciuoglio Скилл aws-lambda-php-integration подсказывает агенту, как развернуть PHP или Symfony на AWS Lambda через Bref: обработчики, слои рантайма, триггеры SQS/SNS и холодный старт. CX Codex +1 3 700установок

Из того же набора51

Весь набор →
bootstrap-check Скилл bootstrap-check проверяет конфигурацию Symfony-проекта перед работой: .env, сервисы, Doctrine, роуты. Показывает, что сломано, и чем это чинить. CX Codex +1 ★ 234звёзд репо ports-and-adapters Скилл ports-and-adapters помогает внедрить гексагональную архитектуру в проектах на Symfony, отделяя чистую доменную логику от Doctrine и внешних библиотек. CX Codex +1 ★ 234звёзд репо config-env-parameters Скилл config-env-parameters для Claude Code помогает менять переменные окружения, параметры и секреты Symfony с учётом разных сред. Задаёт значения и внедряет их в приложение. CX Codex +1 ★ 234звёзд репо doctrine-fixtures-foundry Скилл doctrine-fixtures-foundry для Claude Code учит создавать тестовые данные Doctrine через фабрики Zenstruck Foundry v2: состояния, последовательности и связи. Срабатывает при написании фикстур и миграции фабрик с Foundry v1. CX Codex +1 ★ 234звёзд репо doctrine-batch-processing Скилл doctrine-batch-processing для Claude Code обрабатывает большие наборы данных через Doctrine без загрузки всех сущностей в память. Выполняет импорт, экспорт и массовые изменения. CX Codex +1 ★ 234звёзд репо controller-cleanup Скилл controller-cleanup переносит бизнес-логику из толстых контроллеров Symfony в сервисы, обработчики и команды. Оставляет в действии только делегирование и ответ. CX Codex +1 ★ 234звёзд репо brainstorming Скилл brainstorming структурирует проектирование фич в Symfony: собирает требования, подбирает компоненты фреймворка и сравнивает варианты архитектуры до написания кода. CX Codex +1 ★ 234звёзд репо runner-selection Скилл runner-selection для Claude Code определяет, где запускать PHP-, Composer-, консольные и тестовые команды: в Docker, DDEV или на хосте. Проверяет окружение и задаёт префикс команд. CX Codex +1 ★ 234звёзд репо

Спонсоры проекта

Компании, которые помогают держать аналитику открытой