Event

Was sind Events? 

Ein Ereignis (englisch event) dient in der Softwaretechnik – bei Entwicklung nach dem ereignisorientieren Programmierparadigma – zur Steuerung des Programmflusses. Das Programm wird nicht linear durchlaufen, sondern es werden spezielle Ereignisbehandlungsroutinen (engl. listener, observer, event handler) immer dann ausgeführt, wenn ein bestimmtes Ereignis auftritt. Ereignisorientierte Programmierung gehört zu den parallelen Programmiertechniken, hat also deren Vor- und Nachteile.

(Quelle: Wikipedia)

Integration in brandbox

Der EventHandler steht global in allen Controller-Klassen zur Verfügung. Er liefert den EventDispatcher. Weiterlesen https://symfony.com/doc/current/components/event_dispatcher.html

Ein Event feuern

Die Methode dispatch() benachrichtigt alle Listener und Subscriber über das gegebene Ereignis. Es benötigt zwei Argumente: die Event-Instanz, die an jeden Listener dieses Ereignisses übergeben werden soll, und den Namen des zu versendenden Ereignisses:

$event = new Event\TestEvent();
$this
   ->getEventManager()
   ->dispatch(Event\TestEvent::class, $event)
;

• TestSubscriber muss von \Symfony\Component\EventDispatcher\EventSubscriberInterface ableiten
• Der Subscriber registriert das Event Event\TestEvent::class
• Der Subscriber muss im Ordner Lib/Subscriber liegen

Listener nutzen

Listener liegen in „Lib/Listener/“ und können wie folgt aufgerufen werden:

$listener = new TestListener();
$this
   ->getEventManager()
   ->addListener(Lib\Listener\Test\PopulateTest::class, [$listener, 'process'])
; 

Subscriber nutzen

Bei der Nutzung von Subscribern verzichten wir auf den Aufruf von „addListener“ und nutzen die EventSubscriber-Klassen in „Lib/Subscriber/“ um unsere Event-Listener zu registrieren:

class ComponentValidatorSubscriber extends Event\EventSubscriberAbstract
{
    public static function getSubscribedEvents(): array
    {
        return [
            Event\TestEvent::class => ['onPopulateTest', 800],
        ];
    }

    public function onPopulateTest(Event\TestEvent $event): void
    {
        $this
            ->staticController(Lib\Listener\Test\PopulateTest::class)
            ->process($event)
        ;
    }
}

Wird im Subscriber auf ein Event verwiesen, dass nicht zur Verfügung steht (z.B. weil die App des referenzierten Events nicht installiert ist), wird kein harter Fehler mehr geworfen, sondern ein Debug-Eintrag ins Log geschrieben. Diese Log-Einträge sollten geprüft und, falls möglich, behoben werden.

Umgang mit Events

Der eventDispatcher kann in jeder Controller-Klasse direkt genutzt werden. Der EventHandler stellt die Funktionen des Dispatcher wie folgt zur Verfügung.

$this
  ->getEventHandler()
  ->getDispatcher()
;

App strukturieren

Die Pfade innerhalb eines Packages sind definiert. Siehe Eine App erstellen