slince/event

This package is abandoned and no longer maintained. The author suggests using the slince/event-dispatcher package instead.

Event dispatcher package

2.0.0 2018-06-21 10:22 UTC

Requires

• php: >=5.6.0

Requires (Dev)

• phpunit/phpunit: ^5.0|^6.0

MIT

• Tao

• event
• listener
• event dispatcher
• emitter
• subscriber
• observer pattern

README

Installation

Install via composer.

$ composer require slince/event-dispatcher

Usage

Creates a event dispatcher

$dispatcher = new Slince\EventDispatcher\Dispatcher();

Adds a listener for the specified event

There are two types of listeners: callable and Slince\EventDispatcher\Listener

• Slince\EventDispatcher\Listener

use Slince\EventDispatcher\ListenerInterface;

class FooListener implements ListenerInterface
{
     public function handle(Event $event)
     {
         //do something
     }
}

$dispatcher->addListener('foo-event-name', new FooListener());

• callable

$dispatcher->addListener('foo-event-name', function(Event $event){
    //do something
});

Add a subscriber

use Slince\EventDispatcher\SubscriberInterface;

class FooSubscriber implements SubscriberInterface
{
     public static function getSubscribedEvents(Event $event)
     {
        return [
            'foo' => 'onFoo',
            'bar' => 'onBar'
        ];
     }
     
    public function onFoo(Event $event)
    {
      //do something
    }
    
    public function onBar(Event $event)
    {
       //do something
    }
}

$dispatcher->addSubscriber(new FooSubscriber());

Dispatches the event to the registered listeners

Just provides the event name.

$dispatcher->dispatch('foo-event-name');

You can also dispatch with an event instance.

$dispatcher->dispatch(new Event('foo-event-name'));

Propagation

You can call stopPropagation to stop event propagation on the event instance.

$dispatcher->addListener('foo-event-name', function(Event $event){
    $event->stopPropagation();
});

$emitter->addListener('foo-event-name', function ($event) {
    // This will not be triggered
});

$dispatcher->dispatch('foo-event-name');

Checks whether propagation is stopped

$event = new Event('foo-event-name');
$dispatcher->dispatch($event);

$event->isPropagationStopped();

License

The MIT license. See MIT