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

api-platform-dto-resources — скилл для Claude Code

Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list.

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

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

Что делает api-platform-dto-resources

Скилл автоматизирует создание DTO-ресурсов в API Platform v5, v4.4, v4.3 с Symfony Object Mapper. Вместо того чтобы возвращать сущность напрямую, вы определяете #[ApiResource] класс как DTO и связываете его с entity через #[Map(source: ...)] и #[Map(target: ...)]. Для преобразованных полей (переименования, форматирования, вычисляемые значения) применяется #[Map(transform: ...)].

Скилл охватывает три пути: использование встроенного Object Mapper с stateOptions, создание отдельных input и output классов для разных операций, и написание кастомного ProcessorInterface для сложной логики. Важное ограничение — Object Mapper требует Symfony 7.3+ и не работает на API Platform 3.4 (там нужен ручной маппинг в provider и processor).

Скилл помогает избежать потерь от удаления DataTransformerInterface и даёт знать о том, что на API Platform 5.0 ObjectMapperProcessor переехал в ObjectMapperInputProcessor и ObjectMapperOutputProcessor. Выходной контракт включает классы ресурсов с привязками, выбор пути маппинга и тесты каждой операции.

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

  • Отделить API-контракт от сущности Doctrine
  • Переименовать поля сущности в API без дублирования кода
  • Создать разные формы ввода и вывода для одной операции
  • Мигрировать со снятого DataTransformerInterface на Object Mapper
  • Вычислить и вывести поля, которых нет в entity

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

  • Создай DTO для Entity с переименованием полей через #[Map]
  • Настрой input и output классы для create и update операций
  • Напиши кастомный processor для трансформации сложных данных

Как установить api-platform-dto-resources

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill api-platform-dto-resources -a claude-code

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

~/.claude/skills/api-platform-dto-resources/SKILL.md

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

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

Вопросы об api-platform-dto-resources

Как установить api-platform-dto-resources в Claude Code?

Выполни npx skills add dev-toolings/superpowers-symfony --skill api-platform-dto-resources -a claude-code, затем открой ~/.claude/skills/api-platform-dto-resources/SKILL.md.

Что делает этот скилл?

Автоматизирует маппинг сущностей на DTO в API Platform через Symfony Object Mapper, позволяя отделить API-контракт от Doctrine-entity и создавать разные формы для ввода и вывода данных.

На каких версиях API Platform это работает?

Object Mapper поддерживается на API Platform v5, v4.4, v4.3, но требует Symfony 7.3+. На API Platform 3.4 и Symfony 6.4 LTS нужно маппировать вручную в provider и processor.

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

SKILL.md · MIT
---
name: api-platform-dto-resources
description: Map entities to API DTOs in API Platform (v5, 4.4, 4.3) with the Symfony Object Mapper (#[Map], stateOptions) for decoupled input/output contracts
capabilities: [read, search, edit, shell]
tags: [api-platform]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Api Platform Dto Resources (Symfony)

## Use when
- The `#[ApiResource]` class must be the API contract, decoupled from the Doctrine entity.
- Entity and API fields differ in name or format (rename, formatted price, computed value).
- Create, update, or list operations need their own input or output shape.
- Migrating code that relied on `DataTransformerInterface`, which no longer exists.

## Default workflow
1. Require `symfony/object-mapper` and set `stateOptions: new Options(entityClass: ...)` on the DTO resource.
2. Bind the DTO and the entity with `#[Map(source: ...)]` and `#[Map(target: ...)]`, and use `#[Map(transform: ...)]` for computed fields.
3. For distinct shapes, create input and output classes and wire them with `input:` and `output:` on each operation.
4. When mapping needs real logic, write a custom `ProcessorInterface` that calls `ObjectMapperInterface::map()`.
5. Test each operation: payload in, response shape out.

## Guardrails
- The automatic Object Mapper provider and processor only apply when `stateOptions` has an `entityClass` and both the DTO and the entity carry `#[Map]`.
- `DataTransformerInterface` is gone: use Object Mapper or a provider and processor.
- No Object Mapper on 3.4 or on Symfony 6.4 LTS (it needs Symfony 7.3+): map manually in a `ProviderInterface` and a `ProcessorInterface`.
- `ObjectMapperProcessor` is removed in 5.0: the automatic path uses `ObjectMapperInputProcessor` and `ObjectMapperOutputProcessor` (4.3+).
- Never return the entity itself from a DTO resource: only mapped fields reach the client.

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

## Output contract
- The resource, input, and output classes with their `#[Map]` bindings.
- The mapping path chosen (Object Mapper or custom processor) and why.
- Tests showing the request and response shape of each operation.

## References
- `reference.md`

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

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

Все скиллы по теме «Бэкенд и API» →
symfony-specialist VoltAgent Community Субагент symfony-specialist для Claude, который ведёт разработку на Symfony 6.4, 7.x и 8.0: сущности Doctrine, асинхронная обработка через Messenger, ресурсы API Platform. CX Codex ★ 26 718звёзд репо spring-boot-rest-api-standards giuseppe-trisciuoglio Скилл spring-boot-rest-api-standards задаёт правила проектирования REST API в Spring Boot: от структуры URL и статус-кодов до валидации DTO и перехвата ошибок. CX Codex +1 4 400установок platform-metadata-api-context-get forcedotcom Скилл platform-metadata-api-context-get даёт агенту точную схему 604 типов Salesforce Metadata API, чтобы сгенерированные -meta.xml деплоились без ошибок. CX Codex +1 6 200установок recoup-platform-api-access recoupable Скилл recoup-platform-api-access для Claude Code даёт агенту доступ к REST API платформы Recoup и внешним коннекторам. Он выгружает данные артистов, обновляет документы и отправляет письма. CX Codex +1 5 500установок platform-models-api-configure forcedotcom Скилл platform-models-api-configure настраивает агент на работу через Salesforce Models API с подписанным OrgJWT, проверяет доступ и раскладывает ключи по файлам. CX Codex +1 4 300установок agentic-bundle-aas-api-platform-builder sickn33 and contributors Плагин agentic-bundle-aas-api-platform-builder для Claude Code, устанавливающий редакторский бандл «AAS Backend & API Platform» из коллекции Agentic Awesome Skills. Добавляет готовый набор скиллов для разработки бэкенд-платформ и API. CX Codex ★ 50 109звёзд репо

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

Весь набор →
doctrine-fetch-modes Скилл doctrine-fetch-modes помогает настроить выборку данных в Doctrine ORM и DBAL 4 для Symfony: устраняет проблему N+1, переводит чтение на DTO и конфигурирует отложенную загрузку. 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-filters Скилл api-platform-filters ведёт агента по фильтрам API Platform в Symfony: query-параметры, классы фильтров под установленную версию и свои фильтры для нестандартных запросов. CX Codex +1 ★ 234звёзд репо doctrine-performance-optimizer Субагент doctrine-performance-optimizer проводит аудит кода Doctrine ORM в режиме чтения: находит лишние запросы в цикле, проверяет стратегии загрузки связей и предлагает DTO-гидратацию или составные индексы. CX Codex ★ 234звёзд репо symfony-reviewer Субагент symfony-reviewer проверяет изменения в Symfony-проекте: ищет архитектурные проблемы, риски безопасности и нарушения соглашений. Запускайте после правок или по запросу на ревью. CX Codex ★ 234звёзд репо doctrine-architect Субагент doctrine-architect разбирает сущности Symfony и историю миграций, а на выходе даёт схему связей и план миграции — до того, как вы напишете код. CX Codex ★ 234звёзд репо

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

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