Skip to content

Commit 62b8848

Browse files
Update event_dispatcher.rst
1 parent 7d9e6fe commit 62b8848

File tree

1 file changed

+12
-5
lines changed

1 file changed

+12
-5
lines changed

components/event_dispatcher.rst

Lines changed: 12 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -348,8 +348,16 @@ of the event to dispatch::
348348
// creates the OrderPlacedEvent and dispatches it
349349
$event = new OrderPlacedEvent($order);
350350
$dispatcher->dispatch($event, OrderPlacedEvent::NAME);
351-
// note that the second argument ``OrderPlacedEvent::NAME`` is optional,
352-
// read more below in the subscriber code part
351+
352+
.. versionadded:: 4.3
353+
354+
Since Symfony 4.3, note that the event name is now optional in the :method:`Symfony\\Component\\EventDispatcher\\EventDispatcher::dispatch` method,
355+
so you can pass just the event object as first argument::
356+
357+
// ...
358+
// creates the OrderPlacedEvent and dispatches it
359+
$event = new OrderPlacedEvent($order);
360+
$dispatcher->dispatch($event);
353361

354362
Notice that the special ``OrderPlacedEvent`` object is created and passed to
355363
the ``dispatch()`` method. Now, any listener to the ``order.placed``
@@ -392,10 +400,9 @@ Take the following example of a subscriber that subscribes to the
392400
['onKernelResponsePre', 10],
393401
['onKernelResponsePost', -10],
394402
],
403+
// when using two arguments, the event and the event name
395404
OrderPlacedEvent::NAME => 'onStoreOrder',
396-
// you can also subscribe this way if you pass only
397-
// the event object as first argument and omit the second
398-
// of the $dispatcher->dispatch method
405+
// when using only one argument, the event only (Symfony 4.3+)
399406
OrderPlacedEvent::class => 'onStoreOrder',
400407
];
401408
}

0 commit comments

Comments
 (0)