The Immutable Event Dispatcher

Name: SymfonyWorld 2021 Summer
Start: 2021-06-17
End: 2021-06-18

5.3 version

Maintained

4.4 5.2 5.3 current 5.4 dev 6.0

Unmaintained

2.1 2.2 2.3 2.4 2.5 2.6 2.7 2.8 3.0 3.1 3.2 3.3 3.4 4.0 4.1 4.2 4.3 5.0 5.1

edit this page

Symfony 5.3 is backed by JoliCode.

The Immutable Event Dispatcher¶

The Symfony\Component\EventDispatcher\ImmutableEventDispatcher is a locked or frozen event dispatcher. The dispatcher cannot register new listeners or subscribers.

The ImmutableEventDispatcher takes another event dispatcher with all the listeners and subscribers. The immutable dispatcher is just a proxy of this original dispatcher.

To use it, first create a normal EventDispatcher dispatcher and register some listeners or subscribers:

use Symfony\Component\EventDispatcher\EventDispatcher;

$dispatcher = new EventDispatcher();
$dispatcher->addListener('foo.action', function ($event) {
    // ...
});

// ...

Now, inject that into an ImmutableEventDispatcher:

use Symfony\Component\EventDispatcher\ImmutableEventDispatcher;
// ...

$immutableDispatcher = new ImmutableEventDispatcher($dispatcher);

You’ll need to use this new dispatcher in your project.

If you are trying to execute one of the methods which modifies the dispatcher (e.g. addListener()), a BadMethodCallException is thrown.

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