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
Fabien Potencier 83b087364b Merge branch '4.4' into 5.1
* 4.4:
  Use ::class keyword when possible
2021-01-11 10:50:50 +01:00
..
Bridge fix code style 2021-01-05 08:52:01 +01:00
DataCollector Fix some \Throwable support remaining issues 2019-11-12 18:18:47 +01:00
Event Merge branch '4.4' 2019-09-16 07:06:55 +02:00
EventListener Fix From/Sender handling in Emails 2020-04-16 16:49:30 +02:00
Exception Allow \Throwable $previous everywhere 2019-11-12 15:51:11 +01:00
Header [Mailer] added tag/metadata support 2020-01-30 10:57:20 -05:00
Messenger Merge branch '5.0' into 5.1 2020-06-11 23:20:02 +02:00
Test fix code style 2021-01-04 16:15:05 +01:00
Tests Merge branch '4.4' into 5.1 2021-01-11 10:50:50 +01:00
Transport Merge branch '4.4' into 5.1 2020-12-26 20:36:22 +01:00
.gitattributes add missing gitattributes for phpunit-bridge 2020-03-27 17:54:36 +01:00
.gitignore Add gitignore file for Symfony 4.3 2019-09-17 11:54:03 +02:00
CHANGELOG.md [Mailer] add ability to disable the TLS peer verification via DSN 2020-01-29 08:52:36 +01:00
composer.json Merge branch '4.4' into 5.1 2021-01-10 17:29:19 +01: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 Bump license year 2021-01-01 10:24:35 +01:00
Mailer.php [Mailer] Don't dispatch MessageEvent twice 2020-04-22 17:34:22 +02:00
MailerInterface.php rename SmtpEnvelope to Envelope 2019-09-12 16:17:57 +02:00
phpunit.xml.dist
README.md Fix typo 2020-07-31 08:55:54 +02:00
SentMessage.php Add Message-Id to SentMessage when sending an email 2019-10-12 10:43:49 +02:00
Transport.php Merge branch '4.4' into 5.1 2020-10-28 22:31:18 +01: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