Framework Make Out

Génère une classe Out (DTO immuable pour output).

Vue d'ensemble

Cette skill crée une classe Out qui sert de Data Transfer Object immuable pour exposer les données d'une entité vers l'extérieur.

Caractéristiques

Classe Out générée

Classe final readonly (PHP 8.2+)
Constructeur privé
Factory statique new()
Encapsule l'entité
Complètement immuable
Couche anti-corruption

Utilisation

Use skill framework:make:out

Vous serez invité à fournir le nom de l'entité.

Exemple d'utilisation

EntityName: Product

Génère :

// src/Out/ProductOut.php
final readonly class ProductOut
{
    private function __construct(
        private Product $product,
    ) {}

    public static function new(Product $product): self
    {
        return new self(product: $product);
    }
}

Structure créée

src/
└── Out/
    └── {EntityName}Out.php

Prérequis

L'entité doit exister dans src/Entity/{EntityName}.php
PHP 8.2+ pour readonly classes

Usage recommandé

Dans l'entité

final class Product implements OutInterface
{
    public function out(): ProductOut
    {
        return ProductOut::new(product: $this);
    }
}

Dans un contrôleur

#[Route('/api/products/{id}', methods: ['GET'])]
public function show(Product $product): JsonResponse
{
    return $this->json($product->out());
}

Ajout de méthodes exposées

final readonly class ProductOut
{
    private function __construct(
        private Product $product,
    ) {}

    public static function new(Product $product): self
    {
        return new self(product: $product);
    }

    public function id(): string
    {
        return $this->product->id()->toRfc4122();
    }

    public function name(): string
    {
        return $this->product->name();
    }

    public function formattedPrice(): string
    {
        return number_format($this->product->price(), 2) . ' €';
    }
}

Principes Elegant Objects appliqués

Classe finale
Constructeur privé
Factory statique
Immutabilité totale (readonly)
Encapsulation de l'entité
Pas de getters bruts, méthodes métier