README

This bundle aims to lower the burden of typechecking, casting, loading entities and related annoyances of using requests in your api.

Bundle will automatically hook into Doctrine ORM Bundle and Nelmio API Docs Bundle so no additional configuration should be needed.

Features

Automatic DTO resolution from controller arguments — no manual extraction, casting, or validation wiring
Type coercion for scalars, enums (backed or by case name), dates, and uploaded files
Doctrine entity loading directly from request fields (#[FindOneBy], #[FindBy])
Validator integration — Symfony constraints on properties and fields are enforced in a single pass
Nested DTOs, collections of DTOs, and #[AsRoot] for flat top-level payloads
Nelmio API Doc integration — parameters, request bodies, enum cases, formats, and PHPDoc descriptions are described automatically
Configurable request bags (query, body, headers, cookies, attributes, files) via #[Bag]
Configurable custom #[Action]s for fields, entities and more. Set custom responses via an easy to handle event.
Event hooks for resolved / invalid / action scenarios — return custom responses from listeners
Symfony profiler panel with per-request DTO resolution timings
Cached metadata via opcache-backed PHP files — near-zero reflection cost after warm-up

Install

composer require dualmedia/symfony-request-dto-bundle

Then add the bundle to your config/bundles.php file like so

return [
    Symfony\Bundle\FrameworkBundle\FrameworkBundle::class => ['all' => true],
    // other bundles ...
    DualMedia\DtoRequestBundle\DtoBundle::class => ['all' => true],
];

If applicable your Doctrine entity managers will be detected automatically and used as default providers for classes to be loaded with your requests if needed.

Quick start

use DualMedia\DtoRequestBundle\Dto\AbstractDto;
use DualMedia\DtoRequestBundle\Dto\Attribute\Bag;
use DualMedia\DtoRequestBundle\Metadata\Enum\BagEnum;
use Symfony\Component\HttpFoundation\File\UploadedFile;

// input:
// [
//     'name' => 'John',
//     'age' => '25',
//     'score' => '9.5',
//     'active' => '1',
//     'avatar' => <UploadedFile>,
// ]

class ProfileDto extends AbstractDto
{
    public string|null $name = null;

    public int|null $age = null;

    public float|null $score = null;

    public bool|null $active = null;

    #[Bag(BagEnum::Files)]
    public UploadedFile|null $avatar = null;
}

More examples

See EXAMPLES.md for enums, dates, nested DTOs, entity loading, and root-level payloads.

Upgrades

See CHANGES.md

dualmedia / symfony-request-dto-bundle

Maintainers

Package info

Statistics

Security