@@ -348,8 +348,16 @@ of the event to dispatch::
348
348
// creates the OrderPlacedEvent and dispatches it
349
349
$event = new OrderPlacedEvent($order);
350
350
$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);
353
361
354
362
Notice that the special ``OrderPlacedEvent `` object is created and passed to
355
363
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
392
400
['onKernelResponsePre', 10],
393
401
['onKernelResponsePost', -10],
394
402
],
403
+ // when using two arguments, the event and the event name
395
404
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+)
399
406
OrderPlacedEvent::class => 'onStoreOrder',
400
407
];
401
408
}
0 commit comments