Create Composite

Composite Pattern Generator

Creates Composite pattern infrastructure for treating individual objects and compositions uniformly.

When to Use

Component Characteristics

Component Interface

• Defines operations for all objects
• Shared by leaf and composite
• Enables uniform treatment

Leaf

• Represents individual object
• No children
• Implements component operations

Composite

• Contains children (leaf or composite)
• Delegates operations to children
• Implements component operations

Generation Process

Step 1: Generate Component Interface

Path: src/Domain/{BoundedContext}/

1. {Name}Interface.php — Operations contract

Step 2: Generate Leaf

Path: src/Domain/{BoundedContext}/

1. {Name}Leaf.php — Individual object

Step 3: Generate Composite

Path: src/Domain/{BoundedContext}/

1. {Name}Composite.php — Container for children

Step 4: Generate Tests

1. {ClassName}Test.php — Component behavior verification

File Placement

Naming Conventions

Quick Template Reference

Component Interface

interface {Name}Interface
{
    public function {operation}(): {returnType};
}

Leaf

final readonly class {Name} implements {Name}Interface
{
    public function {operation}(): {returnType}
    {
        return {leafBehavior};
    }
}

Composite

final class {Name}Composite implements {Name}Interface
{
    private array $children = [];

    public function add({Name}Interface $child): void
    {
        $this->children[] = $child;
    }

    public function {operation}(): {returnType}
    {
        $result = {initialValue};

        foreach ($this->children as $child) {
            $result {combineOperation} $child->{operation}();
        }

        return $result;
    }
}

Usage Example

$menu = new MenuComposite('Products');
$menu->add(new MenuItem('Laptops'));

$submenu = new MenuComposite('Accessories');
$submenu->add(new MenuItem('Mouse'));
$submenu->add(new MenuItem('Keyboard'));

$menu->add($submenu);

// Uniform treatment
$menu->render();

Common Composites

Anti-patterns to Avoid

References

For complete PHP templates and examples, see:

• references/templates.md — Component interface, leaf, composite templates
• references/examples.md — Menu, permission, price rule composites with unit tests