Back to the basics... Fabien Potencier @fabpot

Symfony MIME Everything you need to create beautiful emails Fabien Potencier @fabpot

Symfony Mime

use Symfony\Component\Mime\Email; $email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->text('Some text message') ->html('Some HTML message') ->attach('doc.txt') ; The basics

$email = (new Email()) ->from('fabien@symfony.com') ->to(new Address('fabien@sensiolabs.com')) ->addTo(new NamedAddress('fabien@sensiolabs.com', 'Fabien')) ->addCc('thomas@symfony.com', 'lucas@symfony.com') ->addCc(...['thomas@symfony.com', 'lucas@symfony.com']) ->subject('Some subject') ->text('Some text') ; from, to, cc, bcc

$email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->text('Some text message') ->html('Some HTML message') ; echo strlen(serialize($email)); Email is a data object Only 2k vs 16k for Swiftmailer

Why is it so different
 from Swiftmailer?

$email = (new Email()) ->text('Some text message') ->html('Some HTML message') ; $email = (new \Swift_Message()) ->setBody('Some text message') ->addPart('Some HTML message', 'text/html') ; A better data object model 16k serialized 38 objects complex serialization "fixed" headers 2k serialized 7 objects simple serialization "dynamic" headers

echo $email->toString(); sleep(2); $email->to('helene@symfony.com'); echo $email->toString(); Fixed vs dynamic headers Different
 set of headers Date, Boundary, Message-ID

$email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->text(fopen('email.txt', 'r')) ->html(fopen('email.html', 'r')) ; echo $email->toString(); foreach ($email->toIterable() as $chunk) { echo $chunk; } String or resources, your choice

// Email extends Message use Symfony\Component\Mime\Message; use Symfony\Component\Mime\Part\TextPart; use Symfony\Component\Mime\Header\Headers; $body = new TextPart('Some content'); $headers = (new Headers()) ->addMailboxListHeader('From', ['fabien@symfony.com']) ->addMailboxListHeader('To', ['fabien@sensiolabs.com']) ->AddTextHeader('Subject', 'Some subject') ; $email = new Message($headers, $body); And you get full control!

$txt = new TextPart('Some content'); $html = new TextPart('Some content', 'html'); $body = new AlternativePart($txt, $html); $email = new Message($headers, $body); Get creative

A "complete" email multipart/mixed | |------------> multipart/related | | | |------------> multipart/alternative | | | | | ------------> text/plain | | | | | ------------> text/html | | | ------------> image/png | ------------> application/pdf ->text() ->html() ->embed() ->attach()

$email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->setBody($body) ; Mix several approaches

$email ->attach('Some content', 'doc.txt', 'text/plain') ->attachFromPath('/path/to/doc.txt') ->attach(fopen('doc.txt', 'r'), 'doc.txt', 'text/plain') ; Attachments

$email = (new Email()) ->from('fabien@symfony.com') ->to('fabien@sensiolabs.com') ->subject('Some subject') ->text('Some text') ->html('The new logo: ') ->embedFromPath('logo-small.jpg', 'logo.jpg') ; Embeds

// Email extends Message extends RawMessage use Symfony\Component\Mime\RawMessage; $message = new RawMessage($email->toString()); $message->toString(); Go raw! Serialize an email as a string instead of a PHP object

Creating Emails with Twig Twig is perfect for emails aka, Twig is not dead and still very useful :)

use Symfony\Bridge\Twig\Mime\BodyRenderer; use Symfony\Bridge\Twig\Mime\TemplatedEmail; use Twig\Environment; use Twig\Loader\FilesystemLoader; use Symfony\Component\Mime\NamedAddress; $twig = new Environment($loader = new FilesystemLoader(__DIR__.'/templates')); $loader->addPath(__DIR__.'/images', 'images'); $email = (new TemplatedEmail()) ->from('fabien@symfony.com') ->to(new NamedAddress('fabien@sensiolabs.com', 'Fabien')) ->text('Some text content') ->htmlTemplate('simple.html.twig') ->context([ 'city' => 'Lille' ]) ; $renderer = new BodyRenderer($twig); $renderer->render($email); echo $email->toString(); Native integration with Twig

Welcome {{ email.toName }} from {{ city }}!

Native integration with Twig Symfony\Bridge\Twig\Mime\ WrappedTemplatedEmail Twig template name Template context

{% do email.attach('@docs/doc.pdf') %}

Welcome {{ email.toName }}!

Native integration with Twig

{% do email.priority(5) %}

Welcome {{ email.toName }}!

Native integration with Twig

$email = (new TemplatedEmail()) ->from('fabien@symfony.com') ->to(new NamedAddress('fabien@sensiolabs.com', 'Fabien')) ->textTemplate('simple.txt.twig') ->htmlTemplate('simple.html.twig') ; Native integration with Twig

$email = (new TemplatedEmail()) ->from('fabien@symfony.com') ->to(new NamedAddress('fabien@sensiolabs.com', 'Fabien')) ->template('simple.email.twig') ; Native integration with Twig

{% block config %} {% do email.attach('@images/planfaidherbe.jpeg') %} {% endblock %} {% block subject %}Email Subject{% endblock %} {% block text %} Optional text representation {% endblock %} {% block html %}

Welcome {{ email.toName }}!

{% endblock %} Native integration with Twig

{% block text %} {% set formula = "2 > 1?" %} {% autoescape false %} {{ formula }} {% endautoescape %} {% endblock %} {% block html %} {% set formula = "2 > 1?" %} {{ formula }} {% endblock %} Native integration with Twig HTML escape by default with the "name" strategy From: fabien@symfony.com To: Fabien MIME-Version: 1.0 Date: Thu, 28 Feb 2019 12:10:16 +0100 Message-ID: <7885775f35b0509444e99290be3216e2@symfony.com> Content-Type: multipart/alternative; boundary="_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_= --_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_=_ Content-Type: text/plain; charset=utf-8 Content-Transfer-Encoding: quoted-printable =20 2 > 1? =20 --_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_=_ Content-Type: text/html; charset=utf-8 Content-Transfer-Encoding: quoted-printable =20 2 > 1? --_=_symfony_1551352216_9df84f01f42af586d65b48578466206f_=_--

Tip! If the Text part is empty, the BodyRenderer automatically generates one

But HTML in emails is hard Compatibility with email clients Inline CSS Responsive layout …

use Twig\CssInliner\CssInlinerExtension; $twig->addExtension(new CssInlinerExtension()); {% filter inline_css %} b { color: red }

Welcome {{ email.toName }}!

{% endfilter %} Inlining CSS

{% filter inline_css("@css/email.css") %} b { color: red }

Welcome {{ email.toName }}!

{% endfilter %} Inlining CSS

use Twig\Markdown\MarkdownExtension; $twig->addExtension(new MarkdownExtension());

{% filter markdown %} | Version | LTS? | Latest | | ------------- |:-------------:| -------:| | 1.0 | Yes | 1.0.1 | | 2.1 | No | 2.1.33 | {% endfilter %}

Use Markdown to simplify your templates

use Twig\Inky\InkyExtension; $twig->addExtension(new InkyExtension()); Use Inky to simplify your HTML https://foundation.zurb.com/emails.html

{% filter inky|inline_css(source("@zurb/stylesheets/main.css")) %}

Symfony Connect

Forgot Your Password?

It happens. Click the link below to reset it.

Reset Password

---

unsubscribe here.

{% endfilter %} Use Inky to simplify your HTML

What about sending
 our emails now?

Symfony Mailer Everything you need to send emails Fabien Potencier @fabpot

Symfony Mailer

For transactional emails

$transport = new SmtpTransport('localhost'); $transport->send($email); The basics Email is sent for everybody or not at all

Email Transports

new SmtpTransport('localhost'); SMTP: Your server

new GmailTransport('user', 'pass'); new MailgunTransport('user', 'pass'); new SendgridTransport('key'); new PostmarkTransport('id'); … SMTP: Shortcuts

new MailgunTransport('user', 'pass'); … HTTP: Raw message

new MailgunTransport('user', 'pass'); new PostmarkTransport('id'); … HTTP: Via API

Transport::fromDsn('...'); smtp://user:pass@gmail smtp://key@sendgrid smtp://null smtp://user:pass@mailgun http://key:domain@mailgun api://id@postmark Use a DSN

Transport::fromDsn('...'); Failover api://id@postmark || smtp://key@sendgrid RoundRobin api://id@postmark && smtp://key@sendgrid Failover and RoundRobin transports

Popular Providers Built-in Support Amazon SES Google Gmail Mandrill Mailgun Postmark Sendgrid

Unified behaviour across all providers Same events for all transports Unified DSNs / one env var MAILER_DSN Easily switch from SMTP in dev to a "real" provider in prod / same API Same message interface and serialization

SMTP / HTTP / API? SMTP HTTP API Offline Yes via Mailcatcher No / Mock No / Mock Mailcatcher Yes No No Standard Yes No No Symfony generated Yes Yes No Fast No Yes Yes

public function email(TransportInterface $transport) { $email = (new Email())->…; $transport->send($email); return new Response('Sent'); } Sending emails

Go async?

$transport = Transport::fromDsn('smtp://localhost')); $transport->send($email); $bus->dispatch($email); Messages via Messenger

$mailer = new Mailer($transport); Always sync Sync

$mailer = new Mailer($transport, $bus); Sync if $bus is null OR bus not configured Async is $bus is configured for EnvelopedMessage Sync or Async, your choice

public function email(MailerInterface $mailer) { $email = (new Email())->…; $mailer->send($email); return new Response('Sent... eventually'); } Sync or Async, your choice

public function email(MailerInterface $mailer) { $email = (new Email())->…; $mailer->send($email, new SmtpEnvelope(...)); return new Response('Sent... eventually'); } Sync or Async, your choice

$envelope = new SmtpEnvelope( new Address('sender@example.com'), [new Address('recipient@example.com')] ); SmtpEnvelope

Emails are sent async via AMQP framework: messenger: routing: 'Symfony\Component\Mailer\EnvelopedMessage': amqp Emails are sent immediately framework: messenger: routing: #'Symfony\Component\Mailer\EnvelopedMessage': amqp Sync or Async, your choice

class MessageHandler { private $transport; public function __construct(TransportInterface $transport) { $this->transport = $transport; } public function __invoke(EnvelopedMessage $message) { $this->transport->send($message->getMessage(), $message->getEnvelope()); } } Here is the magic that makes it work!

Message is a data object

* SentMessage instances * Only one event: MessageEvent * Built-in listeners: EnvelopeListener / MessageListener * Throttling / SMTP keep-alive More...

Digression… The Messenger Component ❤ ❤ ❤

Leverages
 the Symfony ecosystem Twig Encore Serializer Messenger PSR logger CSS selector Event Dispatcher Dependency Injection Container Symfony Polyfills (punycode, intl, …) … with all the great features you love in Swiftmailer 6 Symfony Mailer

Thank you! ❤