Factory Generator

Generate DDD-compliant Factories for complex domain object creation.

Factory Characteristics

• •Encapsulates Creation: Hides complex instantiation logic
• •Validates Input: Ensures valid object creation
• •Named Constructors: Provides semantic creation methods
• •Domain Layer: Lives in Domain, no infrastructure dependencies
• •Returns Valid Objects: Never creates invalid domain objects
• •Static or Instance: Static for simple, instance for dependencies

When to Use Factory

Generation Process

Step 1: Determine Factory Type

• •Static Factory: No dependencies, simple validation
• •Instance Factory: Needs domain services or repositories

Step 2: Generate Factory

Path: src/Domain/{BoundedContext}/Factory/

1. •{Entity}Factory.php — Main factory class

Step 3: Define Creation Methods

1. •create() — Primary creation with validation
2. •createFrom{Source}() — Creation from other objects
3. •reconstitute() — Reconstruction from persistence (no validation)

Step 4: Generate Tests

Path: tests/Unit/Domain/{BoundedContext}/Factory/

File Placement

Naming Conventions

Quick Template Reference

Static Factory

final class {Entity}Factory
{
    public static function create({parameters}): {Entity}
    {
        self::validate({parameters});
        return new {Entity}({constructorArgs});
    }

    public static function createFrom{Source}({SourceType} $source): {Entity}
    {
        return new {Entity}({mappedArgs});
    }

    public static function reconstitute({allFields}): {Entity}
    {
        return new {Entity}({allArgs});
    }

    private static function validate({parameters}): void
    {
        {validationLogic}
    }
}

Instance Factory

final readonly class {Entity}Factory
{
    public function __construct(
        private {DomainService} $service,
        private {Repository} $repository
    ) {}

    public function create({parameters}): {Entity}
    {
        {creationLogicWithDependencies}
    }
}

Anti-patterns to Avoid

References

For complete PHP templates and examples, see:

• •references/templates.md — Static Factory, Instance Factory, Test templates
• •references/examples.md — Order, User, Policy factory examples and tests