Proxy Pattern Generator

Creates Proxy pattern infrastructure for controlling access to objects.

When to Use

Component Characteristics

Subject Interface

• Defines operations
• Shared by proxy and real subject
• Enables transparent substitution

Real Subject

• Actual implementation
• Contains business logic
• May be expensive to create

Proxy

• Implements subject interface
• Controls access to real subject
• Adds additional behavior

Generation Process

Step 1: Generate Subject Interface

Path: src/Domain/{BoundedContext}/

1. {Name}Interface.php — Operations contract

Step 2: Generate Proxy

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

1. Lazy{Name}Proxy.php — Lazy initialization
2. Caching{Name}Proxy.php — Result caching
3. AccessControl{Name}Proxy.php — Permission checks
4. Logging{Name}Proxy.php — Call logging

Step 3: Generate Tests

1. {ProxyName}Test.php — Proxy behavior verification

File Placement

Naming Conventions

Quick Template Reference

Proxy

final class {Type}{Name}Proxy implements {Name}Interface
{
    private ?{Name}Interface $realSubject = null;

    public function __construct(
        private \Closure $factory
    ) {}

    public function {operation}({params}): {returnType}
    {
        {beforeBehavior}

        $result = $this->getRealSubject()->{operation}({args});

        {afterBehavior}

        return $result;
    }

    private function getRealSubject(): {Name}Interface
    {
        if ($this->realSubject === null) {
            $this->realSubject = ($this->factory)();
        }

        return $this->realSubject;
    }
}

Usage Example

// Lazy loading proxy
$repository = new LazyUserRepositoryProxy(
    fn() => new UserRepository($connection)
);

// Real subject created only on first call
$user = $repository->findById($id);

Common Proxies

Anti-patterns to Avoid

References

For complete PHP templates and examples, see:

• references/templates.md — Lazy loading, caching, access control proxy templates
• references/examples.md — Repository, service proxies with unit tests