Plugin System

The plugin system implements the Port & Adapter pattern, providing extensible framework capabilities through interfaces (Ports) and implementations (Adapters).

In This Section

• Command Bus - Dispatch commands to handlers
• Query Bus - Dispatch queries to handlers
• Event Bus - Publish and subscribe to domain events
• Dispatcher - PSR-14 event dispatching and listener registration
• Transaction - Database transaction management
• SQL Driver - Database connection abstraction
• Logger - Logging abstraction
• Session - Session management
• Authorization - RBAC permission checking
• Cache - PSR-16 compliant key-value caching with TTL support
• Password Hasher - Secure password hashing
• ID Generator - Unique identifier generation
• Clock - Testable time operations

Plugin Structure

Each plugin in src/Plugin/ contains:

• Port/ - Interfaces defining the contract
• Adapter/ - One or more implementations
• Internal/ (optional) - Plugin-internal utilities

Available Plugins

Usage Pattern

Depend on Ports (interfaces), never on Adapters directly:

public function __construct(
    private readonly LoggerInterface $logger,
) {}

Configure adapter selection in config/{app}/container.php:

LoggerInterface::class => DI\get(FileLogger::class),