Recherche…


Syntaxe

  • $ dispatcher-> dispatch (string $ eventName, Event $ event);
  • $ dispatcher-> addListener (string $ eventName, callable $ listener, int $ priority = 0);
  • $ dispatcher-> addSubscriber (EventSubscriberInterface $ abonné);

Remarques

  • Il est souvent préférable d'utiliser une seule instance de EventDispatcher dans votre application que vous injectez dans les objets devant déclencher des événements.
  • Il est recommandé d’avoir un seul emplacement où vous gérez la configuration et d’ajouter des écouteurs d’événement à votre EventDispatcher. Le framework Symfony utilise le conteneur d'injection de dépendances.
  • Ces modèles vous permettront de changer facilement vos écouteurs d'événement sans avoir à modifier le code d'un module qui distribue des événements.
  • Le découplage de la répartition des événements de la configuration de l'écouteur d'événements est ce qui rend le Symfony EventDispatcher si puissant
  • EventDispatcher vous aide à satisfaire le principe ouvert / fermé.

Démarrage rapide du répartiteur d'événements

use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\EventDispatcher\Event;
use Symfony\Component\EventDispatcher\GenericEvent;

// you may store this in a dependency injection container for use as a service
$dispatcher = new EventDispatcher();

// you can attach listeners to specific events directly with any callable
$dispatcher->addListener('an.event.occurred', function(Event $event) {
    // process $event
});

// somewhere in your system, an event happens
$data = // some important object
$event = new GenericEvent($data, ['more' => 'event information']);

// dispatch the event
// our listener on "an.event.occurred" above will be called with $event
// we could attach many more listeners to this event, and they too would be called
$dispatcher->dispatch('an.event.occurred', $event);

Abonnés aux événements

use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
use Symfony\Component\EventDispatcher\Event;

$dispatcher = new EventDispatcher();

// you can attach event subscribers, which allow a single object to subscribe 
// to many events at once
$dispatcher->addSubscriber(new class implements EventSubscriberInterface {
    public static function getSubscribedEvents()
    {
        // here we subscribe our class methods to listen to various events
        return [
            // when anything fires a "an.event.occurred" call "onEventOccurred"
            'an.event.occurred' => 'onEventOccurred',
            // an array of listeners subscribes multiple methods to one event
            'another.event.happened' => ['whenAnotherHappened', 'sendEmail'],
        ];
    }

    function onEventOccurred(Event $event) {
        // process $event
    }

    function whenAnotherHappened(Event $event) {
        // process $event
    }

    function sendEmail(Event $event) {
        // process $event
    }
});


Modified text is an extract of the original Stack Overflow Documentation
Sous licence CC BY-SA 3.0
Non affilié à Stack Overflow