name: acc-create-decorator description: Generates Decorator pattern for PHP 8.5. Creates wrapper classes for dynamic behavior addition without inheritance. Includes unit tests.

Decorator Pattern Generator

Creates Decorator pattern infrastructure for dynamically adding behavior to objects.

When to Use

Component Characteristics

Component Interface

• Defines core operations
• Shared by concrete and decorators
• Enables transparent wrapping

Abstract Decorator

• Wraps component
• Delegates to wrapped object
• Base for concrete decorators

Concrete Decorators

• Add specific behavior
• Before/after wrapped call
• Can be stacked

Generation Process

Step 1: Generate Component Interface

Path: src/Domain/{BoundedContext}/

1. {Name}Interface.php — Core operations contract

Step 2: Generate Abstract Decorator

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

1. Abstract{Name}Decorator.php — Base decorator with delegation

Step 3: Generate Concrete Decorators

Path: src/Infrastructure/{BoundedContext}/Decorator/

1. Logging{Name}Decorator.php — Logging behavior
2. Caching{Name}Decorator.php — Caching behavior
3. Metrics{Name}Decorator.php — Performance metrics
4. Transactional{Name}Decorator.php — Transaction wrapping

Step 4: Generate Factory (Optional)

Path: src/Infrastructure/{BoundedContext}/

1. {Name}Factory.php — Stack decorators in correct order

Step 5: Generate Tests

1. {Feature}{Name}DecoratorTest.php — Individual decorator tests

File Placement

Naming Conventions

Quick Template Reference

Abstract Decorator

abstract class Abstract{Name}Decorator implements {Name}Interface
{
    public function __construct(
        protected readonly {Name}Interface $wrapped
    ) {}

    public function {operation}({params}): {returnType}
    {
        return $this->wrapped->{operation}({args});
    }
}

Concrete Decorator

final readonly class {Feature}{Name}Decorator extends Abstract{Name}Decorator
{
    public function __construct(
        {Name}Interface $wrapped,
        private {Dependency} $dependency
    ) {
        parent::__construct($wrapped);
    }

    public function {operation}({params}): {returnType}
    {
        {beforeBehavior}
        $result = parent::{operation}({args});
        {afterBehavior}
        return $result;
    }
}

Usage Example

// Stack decorators in order
$service = new TransactionalOrderServiceDecorator(
    new CachingOrderServiceDecorator(
        new MetricsOrderServiceDecorator(
            new LoggingOrderServiceDecorator(
                $baseService,
                $logger
            ),
            $metrics
        ),
        $cache
    ),
    $transaction
);

// Use normally - all decorators execute
$order = $service->create($command);

Common Decorators

Anti-patterns to Avoid

References

For complete PHP templates and examples, see:

• references/templates.md — Abstract Decorator, Concrete Decorator, Interface templates
• references/examples.md — Logging, Caching, Metrics, Transaction decorators and tests