This repository has been archived on 2023-08-20. You can view files and clone it, but cannot push or open issues or pull requests.
symfony/src/Symfony/Component/Mailer
Nicolas Grekas 3e492d6e5d Merge branch '4.4' into 5.1
* 4.4:
  Update versions in composer.json
  [Mime] Fix serialization of RawMessage
2020-10-06 17:50:31 +02:00
..
Bridge Merge branch '4.4' into 5.1 2020-10-06 17:50:31 +02:00
DataCollector
Event
EventListener Fix From/Sender handling in Emails 2020-04-16 16:49:30 +02:00
Exception
Header
Messenger Merge branch '5.0' into 5.1 2020-06-11 23:20:02 +02:00
Test
Tests [Mailer] Fixed 'verify_peer' option in mailer DSN being ignored 2020-08-31 21:52:58 +02:00
Transport Merge branch '4.4' into 5.1 2020-09-07 07:10:28 +02:00
.gitattributes add missing gitattributes for phpunit-bridge 2020-03-27 17:54:36 +01:00
.gitignore
CHANGELOG.md
composer.json Merge branch '4.4' into 5.1 2020-10-06 17:50:31 +02:00
DelayedEnvelope.php [Mailer] Reorder headers used to determine Sender 2020-08-19 19:05:08 +02:00
Envelope.php Merge branch '5.0' into 5.1 2020-07-15 12:53:22 +02:00
LICENSE
Mailer.php [Mailer] Don't dispatch MessageEvent twice 2020-04-22 17:34:22 +02:00
MailerInterface.php
phpunit.xml.dist
README.md Fix typo 2020-07-31 08:55:54 +02:00
SentMessage.php
Transport.php Merge branch '5.0' into 5.1 2020-06-09 13:33:28 +02:00

Mailer Component

The Mailer component helps sending emails.

Getting Started

$ composer require symfony/mailer
use Symfony\Component\Mailer\Transport;
use Symfony\Component\Mailer\Mailer;

$transport = Transport::fromDsn('smtp://localhost');
$mailer = new Mailer($transport);

$email = (new Email())
    ->from('hello@example.com')
    ->to('you@example.com')
    //->cc('cc@example.com')
    //->bcc('bcc@example.com')
    //->replyTo('fabien@example.com')
    //->priority(Email::PRIORITY_HIGH)
    ->subject('Time for Symfony Mailer!')
    ->text('Sending emails is fun again!')
    ->html('<p>See Twig integration for better HTML integration!</p>');

$mailer->send($email);

To enable the Twig integration of the Mailer, require symfony/twig-bridge and set up the BodyRenderer:

use Symfony\Bridge\Twig\Mime\BodyRenderer;
use Symfony\Component\EventDispatcher\EventDispatcher;
use Symfony\Component\Mailer\EventListener\MessageListener;
use Twig\Environment as TwigEnvironment;

$twig = new TwigEnvironment(...);
$messageListener = new MessageListener(new BodyRenderer($twig));

$eventDispatcher = new EventDispatcher();
$eventDispatcher->addSubscriber($messageListener);

$mailer = new Mailer($transport, null, $eventDispatcher);

$email = (new TemplatedEmail())
    // ...
    ->htmlTemplate('emails/signup.html.twig')
    ->context([
        'expiration_date' => new \DateTime('+7 days'),
        'username' => 'foo',
    ])
;
$mailer->mail($email);

Resources