vendor/symfony/mailer/Mailer.php line 45

Open in your IDE?
  1. <?php
  3. /*
  4.  * This file is part of the Symfony package.
  5.  *
  6.  * (c) Fabien Potencier <fabien@symfony.com>
  7.  *
  8.  * For the full copyright and license information, please view the LICENSE
  9.  * file that was distributed with this source code.
  10.  */
  12. namespace Symfony\Component\Mailer;
  14. use Psr\EventDispatcher\EventDispatcherInterface;
  15. use Symfony\Component\EventDispatcher\Event;
  16. use Symfony\Component\EventDispatcher\LegacyEventDispatcherProxy;
  17. use Symfony\Component\Mailer\Event\MessageEvent;
  18. use Symfony\Component\Mailer\Exception\TransportExceptionInterface;
  19. use Symfony\Component\Mailer\Messenger\SendEmailMessage;
  20. use Symfony\Component\Mailer\Transport\TransportInterface;
  21. use Symfony\Component\Messenger\Exception\HandlerFailedException;
  22. use Symfony\Component\Messenger\MessageBusInterface;
  23. use Symfony\Component\Mime\RawMessage;
  24. use Symfony\Contracts\EventDispatcher\EventDispatcherInterface as SymfonyEventDispatcherInterface;
  26. /**
  27.  * @author Fabien Potencier <fabien@symfony.com>
  28.  */
  29. final class Mailer implements MailerInterface
  30. {
  31.     private $transport;
  32.     private $bus;
  33.     private $dispatcher;
  35.     public function __construct(TransportInterface $transport, ?MessageBusInterface $bus = null, ?EventDispatcherInterface $dispatcher = null)
  36.     {
  37.         $this->transport = $transport;
  38.         $this->bus = $bus;
  39.         $this->dispatcher = class_exists(Event::class) && $dispatcher instanceof SymfonyEventDispatcherInterface ? LegacyEventDispatcherProxy::decorate($dispatcher) : $dispatcher;
  40.     }
  42.     public function send(RawMessage $message, ?Envelope $envelope = null): void
  43.     {
  44.         if (null === $this->bus) {
  45.             $this->transport->send($message, $envelope);
  47.             return;
  48.         }
  50.         if (null !== $this->dispatcher) {
  51.             // The dispatched event here has `queued` set to `true`; the goal is NOT to render the message, but to let
  52.             // listeners do something before a message is sent to the queue.
  53.             // We are using a cloned message as we still want to dispatch the **original** message, not the one modified by listeners.
  54.             // That's because the listeners will run again when the email is sent via Messenger by the transport (see `AbstractTransport`).
  55.             // Listeners should act depending on the `$queued` argument of the `MessageEvent` instance.
  56.             $clonedMessage = clone $message;
  57.             $clonedEnvelope = null !== $envelope ? clone $envelope : Envelope::create($clonedMessage);
  58.             $event = new MessageEvent($clonedMessage, $clonedEnvelope, (string) $this->transport, true);
  59.             $this->dispatcher->dispatch($event);
  60.         }
  62.         try {
  63.             $this->bus->dispatch(new SendEmailMessage($message, $envelope));
  64.         } catch (HandlerFailedException $e) {
  65.             foreach ($e->getNestedExceptions() as $nested) {
  66.                 if ($nested instanceof TransportExceptionInterface) {
  67.                     throw $nested;
  68.                 }
  69.             }
  70.             throw $e;
  71.         }
  72.     }
  73. }