@@ -1480,9 +1480,16 @@ the email is sent::
1480
1480
if (!$message instanceof Email) {
1481
1481
return;
1482
1482
}
1483
- // do something with the message
1483
+ // do something with the message (logging, ...)
1484
+
1485
+ // and/or add some Messenger stamps
1486
+ $event->addStamp(new SomeMessengerStamp());
1484
1487
}
1485
1488
1489
+ .. versionadded :: 6.2
1490
+
1491
+ Methods ``addStamp() `` and ``getStamps() `` were introduced in Symfony 6.2.
1492
+
1486
1493
If you want to stop the Message from being sent, call ``reject() `` (it will
1487
1494
also stop the event propagation)::
1488
1495
@@ -1511,48 +1518,6 @@ and their priorities:
1511
1518
1512
1519
$ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\MessageEvent"
1513
1520
1514
- QueuingMessageEvent
1515
- ~~~~~~~~~~~~~~~~~~~
1516
-
1517
- **Event Class **: :class: `Symfony\\ Component\\ Mailer\\ Event\\ QueuingMessageEvent `
1518
-
1519
- .. versionadded :: 6.2
1520
-
1521
- The ``QueuingMessageEvent `` class was introduced in Symfony 6.2.
1522
-
1523
- ``QueuingMessageEvent `` allows to add some logic before the email is sent to
1524
- the Messenger bus (this event is not dispatched when no bus is configured); it
1525
- extends ``MessageEvent `` to allow adding Messenger stamps to the Messenger
1526
- message sent to the bus::
1527
-
1528
- use Symfony\Component\EventDispatcher\EventSubscriberInterface;
1529
- use Symfony\Component\Mailer\Event\QueuingMessageEvent;
1530
- use Symfony\Component\Mime\Email;
1531
-
1532
- public function onMessage(QueuingMessageEvent $event): void
1533
- {
1534
- $message = $event->getMessage();
1535
- if (!$message instanceof Email) {
1536
- return;
1537
- }
1538
- // do something with the message (logging, ...)
1539
-
1540
- // and/or add some Messenger stamps
1541
- $event->addStamp(new SomeMessengerStamp());
1542
- }
1543
-
1544
- This event lets listeners do something before a message is sent to the queue
1545
- (like adding stamps or logging) but any changes to the message or the envelope
1546
- are discarded. To change the message or the envelope, listen to
1547
- ``MessageEvent `` instead.
1548
-
1549
- Execute this command to find out which listeners are registered for this event
1550
- and their priorities:
1551
-
1552
- .. code-block :: terminal
1553
-
1554
- $ php bin/console debug:event-dispatcher "Symfony\Component\Mailer\Event\QueuingMessageEvent"
1555
-
1556
1521
SentMessageEvent
1557
1522
~~~~~~~~~~~~~~~~
1558
1523
0 commit comments