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

doctrine-fetch-modes — скилл для Claude Code

Скилл doctrine-fetch-modes помогает настроить выборку данных в Doctrine ORM и DBAL 4 для Symfony: устраняет проблему N+1, переводит чтение на DTO и конфигурирует отложенную загрузку.

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

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

Что делает doctrine-fetch-modes

Скилл инструктирует Claude Code оптимизировать запросы к базе данных в проектах на Symfony. Он предлагает устранять проблему N+1 через fetch join в репозиториях связкой addSelect() и leftJoin(), настраивать EXTRA_LAZY для больших коллекций и использовать гидратацию в DTO через SELECT NEW.

При переходе на Doctrine ORM 3 синтаксис PARTIAL ломается на версиях с 3.0 по 3.2, поэтому скилл переводит чтение на readonly DTO. Такие объекты не отслеживаются Unit of Work, так что вызывать flush() для них бесполезно. В сырых запросах под DBAL 4 скилл заменяет удалённые query() и fetchAll() на актуальные fetchAllAssociative(), fetchOne() и executeStatement().

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

  • устранить проблему запросов N+1 через fetch join
  • настроить проекцию колонок в readonly DTO через SELECT NEW
  • сконфигурировать EXTRA_LAZY для коллекций в сущностях
  • переписать сырые запросы под методы DBAL 4

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

  • Оптимизируй запрос списка заказов в репозитории, чтобы избавиться от N+1
  • Сделай DTO для страницы пользователей через SELECT NEW вместо выборки полной сущности
  • Переведи методы репозитория с удалённого DBAL fetchAll на вызовы fetchAllAssociative

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/doctrine-fetch-modes/SKILL.md

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

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

Вопросы о doctrine-fetch-modes

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

Выполните команду npx skills add dev-toolings/superpowers-symfony --skill doctrine-fetch-modes -a claude-code.

Что делает doctrine-fetch-modes?

Он помогает оптимизировать выборку в Doctrine: настраивает fetch join, внедряет DTO через SELECT NEW и адаптирует код к DBAL 4.

Почему скилл избегает PARTIAL в DQL?

Конструкция PARTIAL не работает в версиях Doctrine ORM с 3.0 по 3.2, поэтому безопаснее проецировать данные в отдельные DTO.

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

SKILL.md · MIT
---
name: doctrine-fetch-modes
description: Optimize Doctrine fetching with DTO hydration (SELECT NEW), fetch joins, lazy loading, query hints, and DBAL 4 access
capabilities: [read, search, edit, shell]
tags: [doctrine, performance]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Doctrine Fetch Modes (Symfony)

## Use when
- A list or detail endpoint runs one query per row (N+1) on a relation.
- A read-only list needs a few columns, not full managed entities.
- Choosing `LAZY`, `EAGER` or `EXTRA_LAZY` on a mapping, or porting ORM 2 code that relied on `PARTIAL` objects.
- A report or projection query drops to raw SQL through DBAL 4.

## Default workflow
1. Confirm the N+1 or over-fetch in the Symfony profiler before changing any mapping.
2. Keep relations on `fetch: 'LAZY'`; set `fetch: 'EXTRA_LAZY'` on large collections so `count()`, `contains()` and `slice()` run targeted SQL.
3. Load the relations a use case needs with a fetch join in the repository (`addSelect()` plus `leftJoin()`).
4. For read-only lists, project into a `readonly` DTO with `SELECT NEW` (constructor argument order must match the `NEW` list).
5. Use `Query::HINT_READ_ONLY` or an index-by alias (`createQueryBuilder('p', 'p.id')`) when the result is only displayed or looked up by id.
6. For raw SQL, use the DBAL 4 methods (`fetchAllAssociative()`, `fetchOne()`, `executeStatement()`).

## Guardrails
- `PARTIAL` in DQL fails on ORM 3.0 to 3.2 and only returns from 3.3: use `SELECT NEW` DTOs for read-only lists instead.
- Avoid `fetch: 'EAGER'` on a mapping; a fetch join in the query gives the same result per use case.
- `SELECT NEW` returns DTOs, not managed entities: never modify or flush them.
- DBAL 4 removed `query()`, `exec()` and `fetchAll()`.

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

## Output contract
- Repository methods with the fetch strategy chosen per use case.
- DTO classes and the `SELECT NEW` queries that fill them.
- Query count before and after, from the profiler or `doctrine:query:dql --show-sql`.

## 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звёзд репо 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звёзд репо django-perf-review getsentry Скилл django-perf-review проверяет Django-код на N+1 запросы, неограниченные queryset и отсутствующие индексы. Пригодится перед релизом или когда страница тормозит на больших таблицах. CX Codex +1 3 200установок aws-lambda-php-integration giuseppe-trisciuoglio Скилл aws-lambda-php-integration подсказывает агенту, как развернуть PHP или Symfony на AWS Lambda через Bref: обработчики, слои рантайма, триггеры SQS/SNS и холодный старт. CX Codex +1 3 700установок

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

Весь набор →
symfony-messenger Скилл для работы с асинхронными сообщениями через Symfony Messenger: настройка транспортов, обработчиков и стратегий повтора. CX Codex +1 ★ 234звёзд репо api-platform-security Скилл api-platform-security настраивает правила доступа в Symfony API Platform через выражения security, воутеры и хуки жизненного цикла операций. CX Codex +1 ★ 234звёзд репо e2e-panther-playwright Скилл e2e-panther-playwright для Claude Code помогает писать E2E-тесты Symfony: Panther запускает реальный браузер, Playwright берёт сложные сценарии. Тесты проверяют поведение JavaScript, невидимое WebTestCase. CX Codex +1 ★ 234звёзд репо doctrine-relations Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов. CX Codex +1 ★ 234звёзд репо api-platform-resources Скилл api-platform-resources для Claude Code настраивает ресурсы API Platform для REST и GraphQL. Подключается при создании ресурса или настройке операций, пагинации и OpenAPI. CX Codex +1 ★ 234звёзд репо messenger-retry-failures Скилл messenger-retry-failures разбирает сбои обработчиков Symfony Messenger: когда сообщение стоит повторить, когда сразу отправить в failure transport и как потом достать его оттуда. CX Codex +1 ★ 234звёзд репо api-platform-state-providers Скилл api-platform-state-providers помогает настроить кастомные State Provider и Processor в API Platform и Symfony. Отвязывает выборку и сохранение данных от сущностей Doctrine. CX Codex +1 ★ 234звёзд репо api-platform-dto-resources Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list. CX Codex +1 ★ 234звёзд репо

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

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