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