added the Mailer component

Author: fabpot

CHANGELOG.md

@@ -0,0 +1,7 @@
+CHANGELOG
+=========
+
+4.3.0
+-----
+
+ * Added the component

Event/MessageEvent.php

@@ -0,0 +1,55 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Event;
+
+use Symfony\Component\EventDispatcher\Event;
+use Symfony\Component\Mailer\SmtpEnvelope;
+use Symfony\Component\Mime\RawMessage;
+
+/**
+ * Allows the transformation of a Message.
+ *
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class MessageEvent extends Event
+{
+    private $message;
+    private $envelope;
+
+    public function __construct(RawMessage $message, SmtpEnvelope $envelope)
+    {
+        $this->message = $message;
+        $this->envelope = $envelope;
+    }
+
+    public function getMessage(): RawMessage
+    {
+        return $this->message;
+    }
+
+    public function setMessage(RawMessage $message): void
+    {
+        $this->message = $message;
+    }
+
+    public function getEnvelope(): SmtpEnvelope
+    {
+        return $this->envelope;
+    }
+
+    public function setEnvelope(SmtpEnvelope $envelope): void
+    {
+        $this->envelope = $envelope;
+    }
+}

EventListener/EnvelopeListener.php

@@ -0,0 +1,62 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\EventListener;
+
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Mime\Address;
+
+/**
+ * Manipulates the Envelope of a Message.
+ *
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class EnvelopeListener implements EventSubscriberInterface
+{
+    private $sender;
+    private $recipients;
+
+    /**
+     * @param Address|string     $sender
+     * @param (Address|string)[] $recipients
+     */
+    public function __construct($sender = null, array $recipients = null)
+    {
+        if (null !== $sender) {
+            $this->sender = Address::create($sender);
+        }
+        if (null !== $recipients) {
+            $this->recipients = Address::createArray($recipients);
+        }
+    }
+
+    public function onMessage(MessageEvent $event): void
+    {
+        if ($this->sender) {
+            $event->getEnvelope()->setSender($this->sender);
+        }
+
+        if ($this->recipients) {
+            $event->getEnvelope()->setRecipients($this->recipients);
+        }
+    }
+
+    public static function getSubscribedEvents()
+    {
+        return [
+            // should be the last one to allow header changes by other listeners first
+            MessageEvent::class => ['onMessage', -255],
+        ];
+    }
+}

EventListener/MessageListener.php

@@ -0,0 +1,84 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\EventListener;
+
+use Symfony\Component\EventDispatcher\EventSubscriberInterface;
+use Symfony\Component\Mailer\Event\MessageEvent;
+use Symfony\Component\Mime\BodyRendererInterface;
+use Symfony\Component\Mime\Header\Headers;
+use Symfony\Component\Mime\Message;
+
+/**
+ * Manipulates the headers and the body of a Message.
+ *
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class MessageListener implements EventSubscriberInterface
+{
+    private $headers;
+    private $renderer;
+
+    public function __construct(Headers $headers = null, BodyRendererInterface $renderer = null)
+    {
+        $this->headers = $headers;
+        $this->renderer = $renderer;
+    }
+
+    public function onMessage(MessageEvent $event): void
+    {
+        $message = $event->getMessage();
+        if (!$message instanceof Message) {
+            return;
+        }
+
+        $this->setHeaders($message);
+        $this->renderMessage($message);
+    }
+
+    private function setHeaders(Message $message): void
+    {
+        if (!$this->headers) {
+            return;
+        }
+
+        $headers = $message->getHeaders();
+        foreach ($this->headers->getAll() as $name => $header) {
+            if (!$headers->has($name)) {
+                $headers->add($header);
+            } else {
+                if (Headers::isUniqueHeader($name)) {
+                    continue;
+                }
+                $headers->add($header);
+            }
+        }
+        $message->setHeaders($headers);
+    }
+
+    private function renderMessage(Message $message): void
+    {
+        if (!$this->renderer) {
+            return;
+        }
+
+        $this->renderer->render($message);
+    }
+
+    public static function getSubscribedEvents()
+    {
+        return [
+            MessageEvent::class => 'onMessage',
+        ];
+    }
+}

Exception/ExceptionInterface.php

@@ -0,0 +1,23 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * Exception interface for all exceptions thrown by the component.
+ *
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+interface ExceptionInterface extends \Throwable
+{
+}

Exception/HttpTransportException.php

@@ -0,0 +1,21 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class HttpTransportException extends TransportException
+{
+}

Exception/InvalidArgumentException.php

@@ -0,0 +1,21 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class InvalidArgumentException extends \InvalidArgumentException implements ExceptionInterface
+{
+}

Exception/LogicException.php

@@ -0,0 +1,21 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class LogicException extends \LogicException implements ExceptionInterface
+{
+}

Exception/RuntimeException.php

@@ -0,0 +1,21 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class RuntimeException extends \RuntimeException implements ExceptionInterface
+{
+}

Exception/TransportException.php

@@ -0,0 +1,21 @@
+<?php
+
+/*
+ * This file is part of the Symfony package.
+ *
+ * (c) Fabien Potencier <[email protected]>
+ *
+ * For the full copyright and license information, please view the LICENSE
+ * file that was distributed with this source code.
+ */
+
+namespace Symfony\Component\Mailer\Exception;
+
+/**
+ * @author Fabien Potencier <[email protected]>
+ *
+ * @experimental in 4.3
+ */
+class TransportException extends RuntimeException implements TransportExceptionInterface
+{
+}