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

api-platform-state-providers — скилл для Claude Code: установка

Скилл api-platform-state-providers помогает настроить кастомные State Provider и Processor в API Platform и Symfony. Отвязывает выборку и сохранение данных от сущностей Doctrine.

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

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

Что делает api-platform-state-providers

Скилл направляет Claude Code при реализации ProviderInterface и ProcessorInterface в проектах на Symfony с API Platform версий 4.3, 4.4 и v5. Ассистент создаёт провайдеры для чтения данных из внешних API или оборачивает встроенные Doctrine-сервисы с помощью атрибута #[Autowire].

Для операций записи скилл генерирует процессоры, делегирующие вызовы в persist_processor или remove_processor. Учтите: устаревшие интерфейсы DataProvider и DataPersister из второй версии API Platform удалены, а флаг write: true для GET-операций поддерживается только в v4.

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

  • получить данные ресурса из внешнего источника вместо Doctrine ORM
  • обернуть стандартный Doctrine Provider для отдачи DTO или фильтрации тенанта
  • выполнить хэширование или отправку сообщений перед сохранением сущности
  • настроить запуск процессора на GET-эндпоинте с флагом write: true

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

  • Создай State Provider для чтения профиля пользователя через внешний REST API.
  • Оберни Doctrine Item Provider, чтобы отдавать DTO вместо сущности Order.
  • Напиши State Processor для хеширования пароля перед вызовом persist.

Как установить api-platform-state-providers

1Через Skills CLI (Vercel)

npx skills add dev-toolings/superpowers-symfony --skill api-platform-state-providers -a claude-code

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

~/.claude/skills/api-platform-state-providers/SKILL.md

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

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

Вопросы об api-platform-state-providers

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

Выполните команду npx skills add dev-toolings/superpowers-symfony --skill api-platform-state-providers -a claude-code. Альтернативный вариант — поместить файл по пути ~/.claude/skills/api-platform-state-providers/SKILL.md.

Что делает скилл api-platform-state-providers?

Он задаёт правила проектирования State Providers и Processors в API Platform. Это позволяет изолировать логику хранения, использовать DTO и тестировать сценарии успеха, 404 и побочные эффекты.

Поддерживает ли скилл DataProvider из API Platform v2?

Интерфейсы DataProvider и DataPersister устарели и не используются. Скилл работает с современными ProviderInterface и ProcessorInterface.

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

SKILL.md · MIT
---
name: api-platform-state-providers
description: Master API Platform State Providers and Processors (v5, 4.4, 4.3) (ProviderInterface/ProcessorInterface) to decouple data retrieval and persistence from entities
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 State Providers (Symfony)

## Use when
- Reading data from a source other than the default Doctrine provider.
- Wrapping the Doctrine provider to post-process results (return a DTO, enforce a tenant scope).
- Business logic must run before or after persisting (hashing, slug, dispatching a message).
- A v4 read endpoint must dispatch a query or command through a processor.

## Default workflow
1. Implement `ProviderInterface::provide()` returning `iterable|object|null`, where `null` gives a 404 (v3.4 declares `mixed`).
2. To keep Doctrine fetching, inject `api_platform.doctrine.orm.state.item_provider` and `api_platform.doctrine.orm.state.collection_provider` with `#[Autowire]`.
3. Implement `ProcessorInterface::process()` and delegate to `api_platform.doctrine.orm.state.persist_processor` or `remove_processor`.
4. Wire them with `provider:` and `processor:` on the resource or the operation; autoconfiguration registers them, and the `api_platform.state_provider` or `api_platform.state_processor` tag is only needed without it.
5. For a processor on `GET` or `GetCollection`, add `write: true` (v4 only).

## Guardrails
- Run pre-persist logic before calling the inner processor and side effects after it returns.
- A processor returns the created or modified object, and nothing for `DELETE`.
- `write: true` on safe methods is v4 only: v3.4 processors run on write methods only.
- `DataProvider` and `DataPersister` are v2 interfaces and no longer exist.

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

## Output contract
- The providers and processors added, and the operations they are wired to.
- Which built-in services are decorated.
- Tests for the not-found, success, and side-effect paths.

## 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звёзд репо php-symfony официальный github Правило php-symfony для GitHub Copilot, которое держит генерацию кода в рамках официальных практик Symfony. Применяется к PHP, YAML, XML и Twig-файлам, когда ИИ дописывает контроллеры, конфиги или шаблоны. 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установок sentry-php-sdk getsentry Скилл sentry-php-sdk помогает настроить мониторинг Sentry в проектах на чистом PHP, Laravel или Symfony. Распознаёт фреймворк, очереди и планировщики, после чего предлагает нужные пакеты и конфигурацию. CX Codex +1 2 400установок appwrite-php appwrite Скилл appwrite-php подсказывает агенту, как писать серверный PHP под Appwrite: пользователи, таблицы, файлы, функции. Пригодится в Laravel и Symfony. CX Codex +1 898установок php-expert personamanagmentlayer Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок

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

Весь набор →
doctrine-relations Скилл doctrine-relations помогает настроить связи между сущностями Doctrine (OneToMany, ManyToMany, ManyToOne) с правильным выбором сторон, каскадными операциями и защитой от N+1 запросов. CX Codex +1 ★ 234звёзд репо 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-dto-resources Скилл api-platform-dto-resources для Claude Code отделяет API-контракт от Doctrine-сущности в API Platform через Object Mapper. Маппинг учитывает различия полей и отдельные формы для create, update и list. 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звёзд репо

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

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