xervice/event

3.0.0 2018-08-26 19:24 UTC

Requires

• php: >=7.1.0
• xervice/core: ^4.0.0
• xervice/data-provider: ^2.0.0
• xervice/kernel: ^2.0.0

Requires (Dev)

• codeception/codeception: *
• phpstan/phpstan: *
• symfony/var-dumper: *

MIT

• Mike Bertram

README

Installation

composer require xervice/event

Configuration

You can fire events without configuring them. But you must define listener, to handle fired events. To do that, you have to define them in the EventDependencyProvider.

<?php


namespace App\Event;


use Xervice\Event\EventDependencyProvider as XerviceEventDependencyProvider;
use XerviceTest\Event\Listener\TestListener;

class EventDependencyProvider extends XerviceEventDependencyProvider
{
    protected function getListener(): array
    {
        return [
            'test' => [
                TestListener::class //implemente EventListenerInterface
            ]
        ];
    }

}

The EventProvider provide a new event to the target system. In the DefaultEventProvider the events are directly routed to the ListenerProvider. If you want to change the DefaultEventProvider, you can overwrite it in the EventFactory in the method createEventProvider.

    /**
     * @return \Xervice\Event\Business\Provider\EventProviderInterface
     */
    public function createEventProvider(): EventProviderInterface
    {
        return new DefaultEventProvider(
            $this->createListenerProvider()
        );
    }

The listener provider provide the events to the listener.

Using

You can fire new Event over the event facade:

    $newEventContent = new OwnDataProvider(); // DataProviderInterface
    $newEventContent->setData('MyTest');

    $event = new EventDataProvider();
    $event
        ->setName('MY_EVENT_NAME')
        ->setMessage($newEvent);

    $eventFacade->fireEvent($event);