Skip to content

Commit b5a82ca

Browse files
committed
Final changes
1 parent ba9ec6b commit b5a82ca

File tree

1 file changed

+27
-17
lines changed

1 file changed

+27
-17
lines changed

cookbook/event_dispatcher/event_listener.rst

Lines changed: 27 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -23,8 +23,8 @@ Creating an Event Listener
2323

2424
The most common way to listen to an event is to register an **event listener**::
2525

26-
// src/AppBundle/Listener/ExceptionListener.php
27-
namespace AppBundle\Listener;
26+
// src/AppBundle/EventListener/ExceptionListener.php
27+
namespace AppBundle\EventListener;
2828

2929
use Symfony\Component\HttpKernel\Event\GetResponseForExceptionEvent;
3030
use Symfony\Component\HttpFoundation\Response;
@@ -76,23 +76,33 @@ using a special "tag":
7676
7777
# app/config/services.yml
7878
services:
79-
kernel.listener.your_listener_name:
80-
class: AppBundle\Listener\ExceptionListener
79+
app.exception_listener:
80+
class: AppBundle\EventListener\ExceptionListener
8181
tags:
8282
- { name: kernel.event_listener, event: kernel.exception }
8383
8484
.. code-block:: xml
8585
8686
<!-- app/config/services.xml -->
87-
<service id="kernel.listener.your_listener_name" class="AppBundle\Listener\ExceptionListener">
88-
<tag name="kernel.event_listener" event="kernel.exception" />
89-
</service>
87+
<?xml version="1.0" encoding="UTF-8" ?>
88+
<container xmlns="http://symfony.com/schema/dic/services"
89+
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
90+
xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd">
91+
92+
<services>
93+
<service id="app.exception_listener"
94+
class="AppBundle\EventListener\ExceptionListener">
95+
96+
<tag name="kernel.event_listener" event="kernel.exception" />
97+
</service>
98+
</services>
99+
</container>
90100
91101
.. code-block:: php
92102
93103
// app/config/services.php
94104
$container
95-
->register('kernel.listener.your_listener_name', 'AppBundle\Listener\ExceptionListener')
105+
->register('app.exception_listener', 'AppBundle\EventListener\ExceptionListener')
96106
->addTag('kernel.event_listener', array('event' => 'kernel.exception'))
97107
;
98108
@@ -126,8 +136,8 @@ about event subscribers, read :doc:`/components/event_dispatcher/introduction`.
126136
The following example shows an event subscriber that defines several methods which
127137
listen to the same ``kernel.exception`` event::
128138

129-
// src/AppBundle/Subscriber/ExceptionSubscriber.php
130-
namespace AppBundle\Subscriber;
139+
// src/AppBundle/EventSubscriber/ExceptionSubscriber.php
140+
namespace AppBundle\EventSubscriber;
131141

132142
use Symfony\Component\EventDispatcher\EventSubscriberInterface;
133143
use Symfony\Component\HttpFoundation\Response;
@@ -164,8 +174,8 @@ listen to the same ``kernel.exception`` event::
164174
}
165175
}
166176

167-
Now, you just need to register the class as a service and notify Symfony that it
168-
is an event subscriber:
177+
Now, you just need to register the class as a service and add the
178+
``kernel.event_subscriber`` tag to tell Symfony that this is an event subscriber:
169179

170180
.. configuration-block::
171181

@@ -174,7 +184,7 @@ is an event subscriber:
174184
# app/config/services.yml
175185
services:
176186
app.exception_subscriber:
177-
class: AppBundle\Subscriber\ExceptionSubscriber
187+
class: AppBundle\EventSubscriber\ExceptionSubscriber
178188
tags:
179189
- { name: kernel.event_subscriber }
180190
@@ -188,7 +198,7 @@ is an event subscriber:
188198
189199
<services>
190200
<service id="app.exception_subscriber"
191-
class="AppBundle\Subscriber\ExceptionSubscriber">
201+
class="AppBundle\EventSubscriber\ExceptionSubscriber">
192202
193203
<tag name="kernel.event_subscriber"/>
194204
</service>
@@ -201,7 +211,7 @@ is an event subscriber:
201211
$container
202212
->register(
203213
'app.exception_subscriber',
204-
'AppBundle\Subscriber\ExceptionSubscriber'
214+
'AppBundle\EventSubscriber\ExceptionSubscriber'
205215
)
206216
->addTag('kernel.event_subscriber')
207217
;
@@ -214,8 +224,8 @@ sub-requests), which is why when working with the ``KernelEvents::REQUEST``
214224
event, you might need to check the type of the request. This can be easily
215225
done as follow::
216226

217-
// src/AppBundle/Listener/RequestListener.php
218-
namespace AppBundle\Listener;
227+
// src/AppBundle/EventListener/RequestListener.php
228+
namespace AppBundle\EventListener;
219229

220230
use Symfony\Component\HttpKernel\Event\GetResponseEvent;
221231
use Symfony\Component\HttpKernel\HttpKernel;

0 commit comments

Comments
 (0)