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

doctrine-batch-processing — скилл для Claude Code: Doctrine пакетами

Скилл doctrine-batch-processing для Claude Code обрабатывает большие наборы данных через Doctrine без загрузки всех сущностей в память. Выполняет импорт, экспорт и массовые изменения.

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

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

Что делает doctrine-batch-processing

Скилл предлагает измерить объём данных и лимит памяти, читать записи через toIterable() или идти по таблице с пагинацией по ID. После заданного числа элементов цикл вызывает flush() и clear(); нужные после очистки сущности придётся загрузить заново.

Для массовых изменений скилл предлагает выбирать между ORM, DQL и DBAL: DQL и DBAL подходят, когда гидратация сущностей не нужна. Но они обходят lifecycle events и listeners, поэтому проверьте, не зависят ли от них побочные действия. В ORM 3 используйте toIterable() вместо Query#iterate(), а для логирования — middleware вместо setSQLLogger().

Не применяйте findAll() к растущей таблице: выборка может занять слишком много памяти. Скилл также требует явно задать размер пакета и точки очистки, измерить память на реалистичном объёме и сделать запуск возобновляемым.

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

  • обработать импорт, который не помещается в память
  • экспортировать записи потоком через Doctrine
  • массово обновить или удалить строки через DQL
  • загрузить большой объём данных пакетами через Doctrine или DBAL
  • возобновить пакетную обработку после остановки

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

  • Обработай импорт через Doctrine пакетами и добавь замеры памяти до и после.
  • Подготовь экспорт большой таблицы через toIterable() с очисткой EntityManager после каждого пакета.
  • Массово обнови записи: выбери между ORM, DQL и DBAL и учти lifecycle events.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/doctrine-batch-processing/SKILL.md

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

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

Вопросы о doctrine-batch-processing

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

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

Что делает doctrine-batch-processing?

Подсказывает, как читать большие наборы данных потоками или по ID, очищать EntityManager пакетами и выбирать способ массовой записи. Также описывает замеры памяти и контроль рисков.

Чем пагинация по ID отличается от пагинации по offset?

Скилл рекомендует идти по ID: offset становится медленнее и может пропускать строки, если данные меняются.

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

SKILL.md · MIT
---
name: doctrine-batch-processing
description: Process large datasets with Doctrine (ORM 3 toIterable, flush+clear, bulk DQL) and memory management
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 Batch Processing (Symfony)

## Use when
- Processing more rows than fit in memory: imports, exports, backfills.
- A command or worker runs out of memory iterating over entities.
- Updating or deleting many rows at once.
- Inserting large volumes through Doctrine or DBAL.

## Default workflow
1. Measure the dataset size and the memory budget of the process.
2. Stream reads with `toIterable()`, or paginate by id (`id > :lastId`) for very large tables.
3. Flush and `clear()` every N items, and re-fetch anything needed after a clear.
4. Use DQL `UPDATE`/`DELETE` or DBAL for bulk writes that need no hydration.
5. Log memory usage and progress, and make the run resumable.

## Guardrails
- Never `findAll()` on a table that grows.
- Entities loaded before a `clear()` are detached: do not modify or persist them.
- Bulk DQL and DBAL skip lifecycle events and listeners. Check what relies on them.
- On ORM 3, `Query#iterate()` and `setSQLLogger()` are gone: use `toIterable()` and a logging middleware.
- Paginate by id rather than by offset: offsets get slower and skip rows when data moves.

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

## Output contract
- A batch loop with an explicit batch size and clear points.
- The choice between ORM, DQL bulk and DBAL for each write, with the reason.
- Memory measurements before and after on a realistic volume.

## References
- `reference.md`

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

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

Все скиллы по теме «Бэкенд и API» →
symfony-specialist VoltAgent Субагент symfony-specialist разбирает Symfony-задачи: маршруты, контроллеры, сервисы, Doctrine и безопасность. Подключайте его для точечных изменений в существующем приложении. CX Codex ★ 6 505звёзд репо php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. CX Codex +1 ★ 41 430звёзд репо django-perf-review getsentry Скилл django-perf-review проверяет Django-код на N+1 запросы, неограниченные queryset и отсутствующие индексы. Пригодится перед релизом или когда страница тормозит на больших таблицах. CX Codex +1 3 200установок js-batch-dom-css tech-leads-club Правило js-batch-dom-css запрещает чередовать чтение геометрии DOM с записью стилей. Защищает код от синхронного reflow и просадок FPS при анимациях. CX Codex +1 ★ 7 191звёзд репо kafka-stream-processing manutej Скилл kafka-stream-processing снабжает ИИ-агента инструкциями по проектированию потоковой обработки на Apache Kafka. Он пригодится при настройке продюсеров, консьюмеров и топологий Kafka Streams. CX Codex +1 482установок downloading-batch-export-files PostHog Скилл downloading-batch-export-files запускает разовый экспорт событий, сессий или запросов HogQL из PostHog и скачивает полученные файлы Parquet или JSONLines на диск. CX Codex +1 348установок

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

Весь набор →
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-transactions Скилл doctrine-transactions настраивает транзакции в Doctrine ORM 3, блокировки и границы сброса изменений в Symfony. Пригодится при параллельной правке строк и сбоях flush. 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звёзд репо doctrine-events Скилл doctrine-events для Claude помогает навесить побочный эффект на событие сущности Doctrine в Symfony: метки времени, слаг, поисковый индекс, уведомление. CX Codex +1 ★ 234звёзд репо

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

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