SensioLabs
Menu

New in Symfony 4.4: Notification Emails

October 29, 2019 · Published by Avatar of Javier Eguiluz Javier Eguiluz
Fabien Potencier

Contributed by
Fabien Potencier
in #33605.

The Mime component was introduced in Symfony 4.3 to help you create email messages. In Symfony 4.4 we've improved it with notification emails. These emails are standardized messages used to send notifications to yourself (e.g. a new user signed up, some invoice was paid, etc.)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
use Symfony\Bridge\Twig\Mime\NotificationEmail;

$email = (new NotificationEmail())
    ->from('fabien@example.com')
    ->to('fabien@example.org')
    ->subject('My first notification email via Symfony')
    ->markdown(<<<EOF
        There is a **problem** on your website, you should investigate it
        right now. Or just wait, the problem might solves itself automatically,
        we never know.
        EOF
    )
    ->action('More info?', 'https://example.com/')
    ->importance(NotificationEmail::IMPORTANCE_HIGH)
;

Now, use the Mailer component to actually send this message and you'll see something like this in your email client:

A notification email created with Symfony Mime component

Notification emails are already styled with a responsive design based on Foundation for Emails 2, but you can override the theme globally or per email.

Published in #Living on the edge

Help the Symfony project!

As with any Open-Source project, contributing code or documentation is the most common way to help, but we also have a wide range of sponsoring opportunities.

Comments

Avatar of Sébastien Lévêque
Sébastien Lévêque said on Oct 29, 2019
Awesome !
Avatar of Timo
Timo said on Oct 29, 2019
What is exactly the difference between Notification Emails and just sending an Email?
Avatar of Javier Eguiluz
Javier Eguiluz Certified said on Oct 29, 2019
@Thijm under the hood they are the same: just email messages. But "notification emails" come with a predesigned style which is responsive (a normal email is just plain text or raw HTML tags and you need to spend some time styling them).

The "notification emails" also display their priority in a visible way and contain useful shortcuts such as the "action()" method to quickly add clickable buttons in the email message.

In any case, as mentioned above, these emails are intended to send notification to yourself, not to your customers.
Avatar of Matthias Althaus
Matthias Althaus said on Oct 30, 2019
Why the focus on sending notifications to yourself?

This looks fine for stuff like "You've unlocked the first news comment in 2019 badge on symfony.com" or "Your reservation for the SymfonyCon will expire in 2 weeks." which could be send to customers, too?
Avatar of Art Hundiak
Art Hundiak said on Oct 30, 2019
Not to nitpick but the heredoc syntax in the example requires at least 7.3.x to run. It will fail under 7.1.3. Need to move the EOF all they way to the left which in turn can introduce some extra white space.
Avatar of Javier Eguiluz
Javier Eguiluz Certified said on Oct 30, 2019
@Art Hundiak it's not nitpicking. You are right. The example uses the great new flexible HEREDOC syntax introduced in PHP 7.3 (which was released on December 2018).
Avatar of Damir Mitrovic
Damir Mitrovic said on Dec 2, 2019
It should be noted that PHP 7.1 has reached its end of life and should not be used for critical applications as it will not receive security updates. I doubt the team will bother to put the effort in to support unsupported PHP versions. https://www.php.net/supported-versions.php
Avatar of Carles
Carles said on Dec 5, 2019
Hi! I was wondering to try this new great feature, but I got error messages requiring different twig packages. After installing them, I get the following error:
Unknown "inky_to_html" filter

Is there something I am doing wrong?

Thanks!
Avatar of Plaire Cédric
Plaire Cédric said on Dec 5, 2019
hi ! https://symfony.com/doc/current/mailer.html#inky-email-templating-language
this link points to the doc that explains how this very practical framework works
Avatar of Jeff Groves
Jeff Groves said on Dec 17, 2019
I cannot get the example to work with markdown. I'm running it in standard PHP code (not Symfony framework) and am getting this error:

PHP Fatal error: Uncaught Symfony\Component\Mime\Exception\LogicException: A message must have a text or an HTML part or attachments. in /home/avrsites/websites/azvr.com/web/vendor/symfony/mime/Email.php:405

It works fine if I use ->html() or ->text(), but I was hoping I could use ->markdown()

I've tried installing all the suggested extra packages, but I still get the error.
Avatar of Wait4Code
Wait4Code said on Dec 17, 2019
Hi,

I'm trying to override globally the theme of notification email without success...
Any clue ?

thanks

Comments are closed.

To ensure that comments stay relevant, they are closed for old posts.