zumba / symbiosis
Symbiosis, event structure for bootstrapping plugins.
Installs: 54 874
Dependents: 1
Suggesters: 0
Security: 0
Stars: 13
Watchers: 20
Forks: 2
Open Issues: 0
Requires
- php: >=7.2
- psr/event-dispatcher: ^1.0
- psr/log: ^1.1
Requires (Dev)
- phpunit/phpunit: ^8
README
Symbiosis is a drop-in event driven plugin architecture.
The goal is to allow anyone to create a plugin structure for their existing code base using an event oriented system. The secondary benefit of using Symbiosis is that the event structure can be used apart from the plugin structure.
Requirements
PHP 7.2
Setup
- Add as a composer dependency or install directly from composer.
- That's it!
Testing
- Run
composer install --dev
. - Run
./vendor/bin/phpunit
.
Example Plugin Usage
Plugin
<?php namespace \YourApp\Plugin; use \Zumba\Symbiosis\Framework\Plugin, \Zumba\Symbiosis\Event\EventManager, \Zumba\Symbiosis\Framework\Registerable; class SamplePlugin extends Plugin implements Registerable { public function getEvents() { return [ 'sample.someevent' => function($event) { print_r($event->data()); }); ]; } }
Your application bootstrap
<?php use \Zumba\Symbiosis\Plugin\PluginManager; // Somewhere in your application bootstrap, load your plugins $pluginManager = new PluginManager( '/path/to/your/plugin/directory', // Path to where you stored your plugins 'YourApp\Plugin' // namespace defined in your plugins (see example above) ); $pluginManager->loadPlugins();
Your application
<?php use \Zumba\Symbiosis\Event\Event; // Somewhere in your app, trigger plugins listening to event $pluginManager->trigger(new Event('sample.someevent', ['ping' => 'pong']));
Output
Array
(
[ping] => pong
)
Individual Event Registries
As of v1.2
, event registries have been added to allow for separation of events. This allows for "namespacing" your event registries. The EventManager
remains backwards compatible as now the EventManager creates a static instance of an EventRegistry
. Since the event structure is loosely coupled in the Plugin architecture, this allows for namespacing your event registries per plugin.
Example Event Registry namespacing
<?php $registry1 = new \Zumba\Symbiosis\Event\EventRegistry(); $registry2 = new \Zumba\Symbiosis\Event\EventRegistry(); $registry1->register('sample.someevent', function ($event) { print_r($event->data()); }); $registry2->register('sample.someevent', function ($event) { echo "Separate registry\n"; print_r($event->data()); }); $event = new \Zumba\Symbiosis\Event\Event('sample.someevent', array('ping' => 'pong')); $registry1->dispatch($event); // Prints: // Array( // [ping] => pong // ) $registry2->dispatch($event); // Prints: // Separate registry // Array( // [ping] => pong // )
PSR-14 Support
This library is compatible with PSR-14.
One caveat is that the
EventRegistry
requires registration of events that implement\Zumba\Symbiosis\Framework\EventInterface
which includes the\Psr\EventDispatcher\StoppableEventInterface
.
EventRegistry
implements:
\Psr\EventDispatcher\ListenerProviderInterface
\Psr\EventDispatcher\EventDispatcherInterface
Event
implements:
\Psr\EventDispatcher\StoppableEventInterface
See PSR-14 Event Dispatcher Documentation for more details.