Merge branch '6.1' into 6.2

javiereguiluz · javiereguiluz · commit acbd9b2eb39e · 2022-08-11T17:55:01.000+02:00
* 6.1: Add event subscriber example to mailer documentation amqp no autocreate queues, see symfony#16689
diff --git a/mailer.rst b/mailer.rst
@@ -1404,6 +1404,39 @@ Here's an example of making one available to download::
     As it's possible for :class:`Symfony\\Component\\Mime\\DraftEmail`'s to be created
     without a To/From they cannot be sent with the mailer.
 
+Mailer Events
+-------------
+
+MessageEvent
+~~~~~~~~~~~~
+
+``MessageEvent`` allows to change the Message and the Envelope before the email
+is sent::
+
+    use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+    use Symfony\Component\Mailer\Event\MessageEvent;
+    use Symfony\Component\Mime\Email;
+
+    class MailerSubscriber implements EventSubscriberInterface
+    {
+        public static function getSubscribedEvents()
+        {
+            return [
+                MessageEvent::class => 'onMessage',
+            ];
+        }
+
+        public function onMessage(MessageEvent $event): void
+        {
+            $message = $event->getMessage();
+            if (!$message instanceof Email) {
+                return;
+            }
+
+            // do something with the message
+        }
+    }
+
 Development & Debugging
 -----------------------
 
