Update UPGRADE guide of 4.3 for EventDispatcher

alexislefebvre · alexislefebvre · commit 12b12198d157 · 2019-08-11T19:31:37.000+02:00
diff --git a/UPGRADE-4.3.md b/UPGRADE-4.3.md
@@ -55,6 +55,35 @@ EventDispatcher
 ---------------
 
  * The signature of the `EventDispatcherInterface::dispatch()` method should be updated to `dispatch($event, string $eventName = null)`, not doing so is deprecated
+
+   You have to swap arguments when calling `dispatch()`:
+
+   Before:
+   ```php
+   $this->eventDispatcher->dispatch(Events::My_EVENT, $event);
+   ```
+
+   After:
+   ```php
+   $this->eventDispatcher->dispatch($event, Events::My_EVENT);
+   ```
+
+   If your bundle or package needs to provide compatibility with the previous way of using the dispatcher, you can use `Symfony\Component\EventDispatcher\LegacyEventDispatcherProxy::decorate()` to ease upgrades:
+
+   Before:
+   ```php
+   public function __construct(EventDispatcherInterface $eventDispatcher) {
+       $this->eventDispatcher = $eventDispatcher;
+   }   
+   ```
+
+   After:
+   ```php
+   public function __construct(EventDispatcherInterface $eventDispatcher) {   
+       $this->eventDispatcher = LegacyEventDispatcherProxy::decorate($eventDispatcher);
+   }
+   ```
+ 
  * The `Event` class has been deprecated, use `Symfony\Contracts\EventDispatcher\Event` instead
 
 Filesystem
