1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
|
# LazyListener
`Laminas\EventManager\LazyListener` provides a callable wrapper around fetching a
listener from a container and invoking it.
## Usage
To create a `LazyListener` instance, you must pass to its constructor:
- a *definition* of the listener; this is an array defining:
- a `listener` key, with the name of the listener service to pull from the container.
- a `method` key, with the name of the method to invoke on the listener instance.
- a *container*; this is a [PSR-11](https://www.php-fig.org/psr/psr-11/) container,
such as provided by
[laminas-servicemanager](https://github.com/laminas/laminas-servicemanager),
[Aura.Di](https://github.com/auraphp/Aura.Di), etc.
- optionally an `$env` array; this is a set of options or other configuration to
use when creating the listener instance. Since not all containers support
passing additional options at creation, we recommend omitting the `$env`
argument when creating portable applications.
As an example, let's assume:
- We have a listener registered in our container with the service name
`My\Application\Listener`.
- The specific listener method is `onDispatch`.
- You have a PSR-11 container instance in the variable `$container` and an event
manager in the variable `$events`.
You might then create and attach your lazy listener as follows:
```php
use My\Application\Listener;
use Laminas\EventManager\LazyListener;
$events->attach('foo', new LazyListener([
'listener' => Listener::class,
'method' => 'onDispatch',
], $container));
```
`LazyListener` implements the method `__invoke()`, allowing you to attach it
directly as a callable listener!
Internally, it will do essentially the following:
```php
$listener = $container->get($this->listener);
$method = $this->method;
return $listener->{$method}($event);
```
|
