How does pagination work with custom DTOs?

The skill shows how to use the API Platform Pagination service and the TraversablePaginator to return paginated lists of DTOs correctly.

Why use DTOs instead of entities in API Platform?

DTOs decouple your public API contract from your internal database schema, improving security and allowing both to evolve independently without breaking changes.

Can I have different shapes for requests and responses?

Absolutely. This skill demonstrates how to configure separate Input and Output DTOs to ensure users only send or receive the data necessary for a specific operation.

Does this work with any data source?

Yes. Because DTO resources use custom State Providers, you can fetch data from SQL, NoSQL, external APIs, or even local files.

Symfony API Platform DTO Resources

Name: Symfony API Platform DTO Resources
Author: MakFly

byMakFly

•

API Development

Implements API-first design in Symfony by decoupling API resources from database entities using pure Data Transfer Objects (DTOs).

This skill provides a comprehensive guide and implementation pattern for using plain PHP classes (DTOs) as API Platform resources instead of traditional Doctrine entities. By moving logic into custom State Providers and Processors, it allows developers to create clean, versionable, and secure API contracts that are completely decoupled from the underlying database schema. This approach is ideal for complex business logic, multi-source data aggregation, and maintaining strict separation of concerns in modern Symfony applications.

Key Features

0121 GitHub stars

02Decouples API contracts from Doctrine database schemas for cleaner architecture

03Implements custom State Providers and Processors for manual resource handling

04Provides patterns for nested DTO structures and complex data mapping

05Supports separate Input and Output DTOs for precise request/response control

06Enables advanced pagination logic using the TraversablePaginator

Use Cases

01Aggregating data from multiple sources like external APIs, Redis, and SQL into one resource

02Modernizing legacy database structures without breaking existing API contracts

03Designing API-first applications where the public schema evolves independently of storage

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add makfly/superpowers-symfony api-platform-dto-resources

For use in Claude.ai and ChatGPT

Download Skill