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