Symfony Console Commands

Complete reference of all Symfony Console commands for SimpleDTO.

Introduction

SimpleDTO provides several console commands for Symfony:

• make:dto - Create new DTOs
• dto:typescript - Generate TypeScript types
• dto:list - List all DTOs
• dto:validate - Validate DTO structure
• dto:cache - Cache validation rules
• dto:clear - Clear validation cache

make:dto

Create a new DTO class.

Basic Usage

bin/console make:dto UserDTO

Creates src/DTO/UserDTO.php:

<?php

namespace App\DTO;

use event4u\DataHelpers\SimpleDTO;

class UserDTO extends SimpleDTO
{
    public function __construct(
        public readonly int $id,
        public readonly string $name,
    ) {}
}

Options

—validation

Create a DTO with validation attributes:

bin/console make:dto CreateUserDTO --validation

Creates:

<?php

namespace App\DTO;

use event4u\DataHelpers\SimpleDTO;
use event4u\DataHelpers\SimpleDTO\Attributes\Required;
use event4u\DataHelpers\SimpleDTO\Attributes\Email;

class CreateUserDTO extends SimpleDTO
{
    public function __construct(
        #[Required]
        public readonly string $name,

        #[Required, Email]
        public readonly string $email,
    ) {}
}

—resource

Create a resource DTO for API responses:

bin/console make:dto UserResourceDTO --resource

—entity

Create DTO from existing Doctrine entity:

bin/console make:dto UserDTO --entity=User

—force

Overwrite existing DTO:

bin/console make:dto UserDTO --force

dto:typescript

Generate TypeScript types from DTOs.

Basic Usage

bin/console dto:typescript

Generates TypeScript interfaces in assets/types/dtos.ts.

Options

—output

Specify output file:

bin/console dto:typescript --output=assets/types/api.ts

—watch

Watch for changes and regenerate automatically:

bin/console dto:typescript --watch

—export

Specify export type:

bin/console dto:typescript --export=export  # export interface
bin/console dto:typescript --export=declare # declare interface
bin/console dto:typescript --export=        # no export

dto:list

List all DTOs in the project.

Basic Usage

bin/console dto:list

Output:

+------------------+------------------+------------+
| DTO              | Namespace        | Properties |
+------------------+------------------+------------+
| UserDTO          | App\DTO          | 5          |
| CreateUserDTO    | App\DTO\Requests | 3          |
| UserResourceDTO  | App\DTO\Resources| 7          |
+------------------+------------------+------------+

Options

—namespace

Filter by namespace:

bin/console dto:list --namespace=App\\DTO\\Api

dto:validate

Validate DTO structure and configuration.

Basic Usage

bin/console dto:validate UserDTO

Checks:

• Class exists
• Extends SimpleDTO
• Properties are readonly
• Validation attributes are valid
• Type casts are valid
• No circular dependencies

Options

—all

Validate all DTOs:

bin/console dto:validate --all

—fix

Attempt to fix common issues:

bin/console dto:validate UserDTO --fix

dto:cache

Cache validation rules for better performance.

Basic Usage

bin/console dto:cache

Caches validation rules for all DTOs, improving validation performance by up to 198x.

Options

—clear

Clear cache before caching:

bin/console dto:cache --clear

dto:clear

Clear validation rule cache.

Basic Usage

bin/console dto:clear

Clears all cached validation rules.

Real-World Examples

Create API DTOs

# Create request DTO
bin/console make:dto CreateUserDTO --validation

# Create response DTO
bin/console make:dto UserResourceDTO --resource

# Generate TypeScript
bin/console dto:typescript

Development Workflow

# Create DTO from entity
bin/console make:dto OrderDTO --entity=Order

# Validate structure
bin/console dto:validate OrderDTO

# Generate TypeScript with watch
bin/console dto:typescript --watch

CI/CD Pipeline

# Validate all DTOs
bin/console dto:validate --all

# Check TypeScript is up to date
bin/console dto:typescript --check

# Cache validation rules
bin/console dto:cache

Deployment

# Clear old cache
bin/console dto:clear

# Cache validation rules
bin/console dto:cache

# Generate TypeScript
bin/console dto:typescript

Combining Commands

Create and Validate

bin/console make:dto UserDTO && bin/console dto:validate UserDTO

Generate TypeScript and Watch

bin/console dto:typescript --watch &

Best Practices

1. Use Validation in Development

# Always validate after creating DTOs
bin/console make:dto UserDTO
bin/console dto:validate UserDTO

2. Cache in Production

# Add to deployment script
bin/console dto:cache

3. Generate TypeScript Automatically

# Add to composer.json scripts
"scripts": {
    "post-install-cmd": [
        "@php bin/console dto:typescript"
    ]
}

4. Validate in CI/CD

# Add to CI/CD pipeline
bin/console dto:validate --all
bin/console dto:typescript --check

See Also

• Symfony Integration - Symfony integration guide
• TypeScript Generation - TypeScript generation details
• Validation - Validation guide