London 2018 September 28

Berlin 2018 October 24-26

USA 2018 October 11-12

  1. Home
  2. Documentation
  3. Components
  4. Event Dispatcher
  5. The Traceable Event Dispatcher
WARNING: You are browsing the documentation for Symfony 2.5 which is not maintained anymore. Consider upgrading your projects to Symfony 4.1.

The Traceable Event Dispatcher

2.5 version
Maintained
2.8 3.4 4.1 current 4.2 master
Unmaintained
2.3 2.4 2.6 2.7 3.0 3.1 3.2 3.3 4.0

The Traceable Event Dispatcher

New in version 2.5: The TraceableEventDispatcher class was moved to the EventDispatcher component in Symfony 2.5. Before, it was located in the HttpKernel component.

The TraceableEventDispatcher is an event dispatcher that wraps any other event dispatcher and can then be used to determine which event listeners have been called by the dispatcher. Pass the event dispatcher to be wrapped and an instance of the Stopwatch to its constructor:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
use Symfony\Component\EventDispatcher\Debug\TraceableEventDispatcher;
use Symfony\Component\Stopwatch\Stopwatch;

// the event dispatcher to debug
$eventDispatcher = ...;

$traceableEventDispatcher = new TraceableEventDispatcher(
    $eventDispatcher,
    new Stopwatch()
);

Now, the TraceableEventDispatcher can be used like any other event dispatcher to register event listeners and dispatch events:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
// ...

// register an event listener
$eventListener = ...;
$priority = ...;
$traceableEventDispatcher->addListener(
    'event.the_name',
    $eventListener,
    $priority
);

// dispatch an event
$event = ...;
$traceableEventDispatcher->dispatch('event.the_name', $event);

After your application has been processed, you can use the getCalledListeners() method to retrieve an array of event listeners that have been called in your application. Similarly, the getNotCalledListeners() method returns an array of event listeners that have not been called:

1
2
3
4
// ...

$calledListeners = $traceableEventDispatcher->getCalledListeners();
$notCalledListeners = $traceableEventDispatcher->getNotCalledListeners();

This work, including the code samples, is licensed under a Creative Commons BY-SA 3.0 license.