shieldon / event-dispatcher
Event dispatcher for PHP.
Installs: 17 741
Dependents: 2
Suggesters: 0
Security: 0
Stars: 6
Watchers: 4
Forks: 2
Open Issues: 0
Requires
- php: >=7.1.0
Requires (Dev)
- phpunit/phpunit: ^7
This package is auto-updated.
Last update: 2024-10-14 12:12:50 UTC
README
This package is designed as a part of Shieldon Firewall 2. You can also use it on your projects as well.
Installation
Use PHP Composer:
composer require shieldon/event-dispatcher
Or, download it and include the Shieldon autoloader.
require 'autoload.php';
Usage
Add a Listener
/** * @param string $name The name of an event. * @param string|array $func Callable function or class. * @param int $priority The execution priority. * * @return bool */ \Shieldon\Event\Event::addLister(string $name, $func, int $priority = 10): bool
Please note, the priority must be unique. This method returns true when add a listener, false when the prirotiy has been taken by another listener.
Dispatch
/** * @param string $name The name of an event. * @param array $args The arguments. * * @return mixed */ \Shieldon\Event\Event::doDispatch(string $name, array $args = []): mixed
Return the filtered result, it's similar to WordPress' filter. You can ignore the return if you don't need that.
Example
Closure
Add a listener.
\Shieldon\Event\Event::addListener('test_1', function() { echo 'This is a closure function call.'; });
Dispatch.
$result = \Shieldon\Event\Event::doDispatch('test_1');
Function
Function for listener.
function test_event_disptcher() { echo 'This is a function call.'; }
Add a listener.
\Shieldon\Event\Event::addListener('test_2', 'test_event_disptcher');
Dispatch.
$result = \Shieldon\Event\Event::doDispatch('test_2');
Class
Add a listener.
$example = new Example(); \Shieldon\Event\Event::addListener('test_3', [$example, 'example1']);
Dispatch.
$result = \Shieldon\Event\Event::doDispatch('test_3');
Hope this helps.
Author
License
MIT