Create Facade

Facade Pattern Generator

Creates Facade pattern infrastructure for providing simplified access to complex subsystems.

When to Use

Component Characteristics

Facade

• Simple unified interface
• Delegates to subsystem classes
• No business logic, only orchestration
• Lives in Application layer

Subsystem Classes

• Independent complex operations
• Can be used directly or through facade
• Domain or Infrastructure services

Generation Process

Step 1: Generate Facade

Path: src/Application/{BoundedContext}/Facade/

1. {Name}Facade.php — Unified interface to subsystem

Step 2: Identify Subsystem Classes (Existing)

Paths: Domain or Infrastructure services

1. Services, Repositories, External APIs
2. Multiple components with related functionality

Step 3: Generate Tests

1. {FacadeName}Test.php — Facade orchestration verification

File Placement

Naming Conventions

Quick Template Reference

Facade

final readonly class {Name}Facade
{
    public function __construct(
        private {SubsystemA} $subsystemA,
        private {SubsystemB} $subsystemB,
        private {SubsystemC} $subsystemC
    ) {}

    public function {complexOperation}({params}): {returnType}
    {
        $stepA = $this->subsystemA->{methodA}({params});
        $stepB = $this->subsystemB->{methodB}($stepA);
        $stepC = $this->subsystemC->{methodC}($stepB);

        return $stepC;
    }
}

Usage Example

// Without facade - complex coordination
$inventory = $inventoryService->reserve($productId, $quantity);
$payment = $paymentService->charge($amount, $token);
$shipment = $shippingService->schedule($address, $inventory);
$order = $orderRepository->save(new Order(...));
$notificationService->sendConfirmation($order);

// With facade - simple call
$order = $orderFacade->placeOrder($command);

Common Facades

Anti-patterns to Avoid

References

For complete PHP templates and examples, see:

• references/templates.md — Facade templates for order, notification, report systems
• references/examples.md — OrderFacade, NotificationFacade, ReportFacade with unit tests

Converted and distributed by TomeVault — claim your Tome and manage your conversions.