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

api-platform-tests — скилл для Claude Code: тесты API Platform

Скилл api-platform-tests помогает писать функциональные тесты ресурсов API Platform на Symfony: проверять ответы, фильтры, схемы JSON и доступ. Пригодится при добавлении или изменении API-эндпоинтов.

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

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

Что делает api-platform-tests

Скилл задаёт процесс тестирования эндпоинтов API Platform через ApiTestCase: подготовить данные фабриками Foundry, отправить запрос и проверить статус, тип содержимого и JSON. Он охватывает коллекции и отдельные ресурсы, создание, обновление и удаление, а также ошибки валидации и доступа.

В тестах предлагается сбрасывать состояние через #[ResetDatabase] и использовать Factories. Для проверки аутентификации предусмотрен auth_bearer; фильтры и пагинация проверяются по member и totalItems, а форму ответа — по JSON-схеме ресурса. Для PATCH нужен тип содержимого application/merge-patch+json.

Есть ограничение по версиям: #[ResetDatabase] требует PHPUnit 10+ и Foundry 2.9; с PHPUnit 9 нужно использовать трейт ResetDatabase. Ошибка типа свойства с ограничением даёт статус 422 в API Platform 5.0, но 400 в 4.4 и более ранних версиях. Это важно учесть в ожидаемом статусе теста.

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

  • проверить ответы коллекции и отдельного ресурса
  • покрыть создание, обновление и удаление API-ресурсов
  • проверить ошибки валидации и запреты доступа
  • протестировать фильтры и пагинацию
  • сверить ответы с JSON-схемой ресурса

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

  • Напиши функциональные тесты коллекции и отдельного ресурса API Platform через ApiTestCase.
  • Добавь тесты для фильтра и пагинации, проверяя member и totalItems.
  • Покрой анонимный запрос, владельца и другого пользователя, включая ошибки доступа.

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

1Через Skills CLI (Vercel)

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

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

~/.claude/skills/api-platform-tests/SKILL.md

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

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

Вопросы об api-platform-tests

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

Выполните npx skills add dev-toolings/superpowers-symfony --skill api-platform-tests -a claude-code. Скилл доступен по пути ~/.claude/skills/api-platform-tests/SKILL.md.

Что делает api-platform-tests?

Помогает создавать функциональные тесты API Platform на Symfony: проверять эндпоинты, фильтры, пагинацию, JSON-схемы, аутентификацию и ошибки.

Какие версии нужны для #[ResetDatabase]?

Атрибут требует PHPUnit 10+ и Foundry 2.9. Для PHPUnit 9 скилл советует использовать трейт ResetDatabase.

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

SKILL.md · MIT
---
name: api-platform-tests
description: Test API Platform resources with ApiTestCase; assert collections, items, filters, JSON schema, and authentication
capabilities: [read, search, edit, shell]
tags: [api-platform, testing]
# projected by `bun run build` — do not edit by hand
allowed-tools:
  - Read
  - Glob
  - Grep
  - Write
  - Edit
  - Bash
---

# Api Platform Tests (Symfony)

## Use when
- Writing functional tests for API Platform endpoints: collection, item, create, update, delete.
- Asserting validation errors (422) and access control (401, 403).
- Checking filters, pagination, or the JSON schema of responses.
- Setting up a clean database and test data for API tests.

## Default workflow
1. Extend `ApiTestCase` and seed data with Foundry factories (`createOne`, `createMany`).
2. Reset state with `#[ResetDatabase]` and the `Factories` trait, with DAMA rolling back each test.
3. Call `static::createClient()->request()` and assert the status code, content type, and `assertJsonContains()`.
4. Authenticate with `auth_bearer` and cover the anonymous, owner, and other-user cases.
5. Assert `member` and `totalItems` for filters and pagination (`hydra:`-prefixed only with `hydra_prefix: true`).
6. Assert the shape with `assertMatchesResourceItemJsonSchema()` and `assertMatchesResourceCollectionJsonSchema()`.

## Guardrails
- Send `PATCH` with the `application/merge-patch+json` content type.
- `#[ResetDatabase]` needs PHPUnit 10+ and Foundry 2.9: use the `ResetDatabase` trait on PHPUnit 9.
- Cover the failure paths too: 404, 422, 401, 403. A type error on a constrained property is 422 in 5.0 but 400 in 4.4 and earlier.
- Read the configured items per page rather than hardcoding a page size in assertions.

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

## Output contract
- The test classes added and the endpoints they cover.
- Factories and reset strategy used.
- Test run output, including the failure 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звёзд репо ns-backend-tests nextstage-brasil Скилл ns-backend-tests для написания и запуска unit- и интеграционных тестов PHPUnit прямо в IDE. Работает только в Docker-контейнере, помогает быстро покрыть тестами новый Laravel-проект или переписать существующие тесты. CX Codex +1 151установок php-expert personamanagmentlayer Скилл php-expert для Claude Code задаёт агенту правила работы с PHP 8+, Laravel, Composer и PHPUnit. Охватывает разработку, тестирование и ревью современного PHP-кода. CX Codex +1 269установок php-pro VoltAgent Community Субагент php-pro для работы с PHP 8.3+, Laravel и Symfony с акцентом на строгую типизацию, проверку PHPStan девятого уровня и асинхронные шаблоны. CX Codex 2 019установок 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установок

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

Весь набор →
interfaces-and-autowiring Скилл interfaces-and-autowiring настраивает внедрение зависимостей в проектах на Symfony: привязывает интерфейсы, расставляет атрибуты #[Target], #[Autowire] и декорирует сервисы без правок контейнера вручную. CX Codex +1 ★ 234звёзд репо symfony-cache Помогает настроить пулы Symfony Cache, срок жизни записей и сброс по тегам. Защищает от одновременного пересчёта истёкшего ключа. CX Codex +1 ★ 234звёзд репо test-doubles-mocking Скилл test-doubles-mocking помогает создавать тестовые двойники с PHPUnit для изолированного тестирования Symfony-приложений. CX Codex +1 ★ 234звёзд репо rate-limiting Скилл rate-limiting помогает настроить ограничение частоты запросов в Symfony через компонент RateLimiter, атрибуты контроллеров и заголовок Retry-After. CX Codex +1 ★ 234звёзд репо api-platform-serialization Скилл api-platform-serialization настраивает сериализацию API Platform: группы полей на операцию, IRI вместо вложенных объектов, вычисляемые свойства и опции нормализаторов. CX Codex +1 ★ 234звёзд репо symfony-scheduler Настраивает периодические задачи через Symfony Scheduler без системного cron. Запускает генерацию отчётов, очистку данных и синхронизации через Symfony Messenger. CX Codex +1 ★ 234звёзд репо tdd-with-pest Скилл tdd-with-pest для Claude Code ведёт разработку в Symfony через RED-GREEN-REFACTOR с Pest v4. Создаёт тесты, воспроизводит баги и переносит PHPUnit-тесты на синтаксис Pest. CX Codex +1 ★ 234звёзд репо api-platform-versioning Скилл api-platform-versioning помогает менять API на API Platform без ломающих релизов: сначала депрекация с датой sunset, параллельные версии — в крайнем случае. CX Codex +1 ★ 234звёзд репо

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

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