php-fig/event-dispatcher
Event Dispatcher
This project provides a standardized set of interfaces for event-driven communication within PHP applications. It serves as an implementation of the PSR-14 specification, establishing a common contract that allows independent software components to interact without requiring direct knowledge of each other's internal implementations.
The framework facilitates the decoupling of core business logic from secondary tasks by enabling components to trigger and respond to events. It utilizes an observer pattern to notify registered listeners of state changes, routing these events to specific callbacks based on their type. The system ensures predictable execution through synchronous propagation, where listeners are processed sequentially in the main execution thread.
Beyond basic dispatching, the framework supports granular control over the event lifecycle. It allows for application lifecycle hooking and provides mechanisms for listeners to halt event propagation, preventing subsequent handlers from processing an event once a specific condition is met. These features enable the construction of modular systems where components communicate through standardized signals rather than direct method calls.
Features
- PHP Event Dispatchers - Provides a standardized set of interfaces for event-driven communication within PHP applications to decouple business logic from secondary tasks.
- PSR-14 Implementations - Serves as an implementation of the PSR-14 specification, establishing a common contract for event dispatching in PHP.
- Interface-Based Decoupling - Defines standardized contracts that allow independent software components to communicate without requiring direct knowledge of each other's internal implementation.
- Event-Driven Architectures - Facilitates the construction of modular systems where components communicate through standardized signals rather than direct method calls.
- Interrupt Signal Binding - Provides mechanisms for listeners to halt event propagation, preventing subsequent handlers from processing an event once a specific condition is met.
- PHP Interoperability Libraries - Ensures different libraries and frameworks can exchange event data seamlessly by following a shared standard for dispatching and listening.
- Type-Based Mappers - Routes events to specific callback collections by matching the event object class to the registered listener requirements at runtime.
- Propagation Halting - Supports halting event propagation, allowing listeners to prevent subsequent handlers from receiving an event once a specific condition is met.
- Execution Lifecycle Hooks - Allows for application lifecycle hooking to modify behavior or perform tasks without changing core files.
- Observer Patterns - Utilizes an observer pattern to notify registered listeners of state changes, routing these events to specific callbacks based on their type.
- Synchronous Dispatchers - Ensures predictable execution through synchronous propagation, where listeners are processed sequentially in the main execution thread.
- Event Listener Managers - Allows developers to register callback functions for specific event types, ensuring automatic execution of associated logic during the application lifecycle.
