New in Symfony 6.1: Draft Emails

Contributed by Kevin Bond in #44311.

In HTML it's possible to create email links that, when clicked, open a new email message with some pre-filled information rather than linking to some other page:

Send email

Send email

However, sometimes you need to create a full email, with lots of contents and even file attachments. You can't do that with the mailto: feature. That's why Symfony 6.1 will add a feature to create draft emails. Draft emails are email messages created as a file with the .eml extension and with the X-Unsent header set. This allows email clients to interpret them as draft emails that you can use to create the email to be sent. First, use the new DraftEmail class to create those emails:

    use Symfony\Component\Mime\DraftEmail;

$message = (new DraftEmail()) // ... ->html($this->renderView('...')) ->attach('...');

Now you can define a controller that downloads this draft email as a .eml file:

    // src/Controller/DownloadEmailController.php

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController; use Symfony\Component\HttpFoundation\Response; use Symfony\Component\HttpFoundation\ResponseHeaderBag; use Symfony\Component\Mime\DraftEmail; use Symfony\Component\Routing\Annotation\Route;

class BudgetController extends AbstractController {

[Route('/budget/estimate-generator/{clientId}')]

public function estimateGenerator(): Response
{
    // ...

    $message = (new DraftEmail())
        ->subject('Your estimate is now available')
        ->html($this->renderView('...'))
        ->attach('...');

    $response = new Response($message->toString());
    $contentDisposition = $response->headers->makeDisposition(
        ResponseHeaderBag::DISPOSITION_ATTACHMENT,
        'estimate.eml'
    );
    $response->headers->set('Content-Type', 'message/rfc822');
    $response->headers->set('Content-Disposition', $contentDisposition);

    return $response;
}

}

                Sponsor the Symfony project.

https://symfony.com/blog/new-in-symfony-6-1-draft-emails?utm_source=Symfony%20Blog%20Feed&utm_medium=feed

Created 3y | Apr 29, 2022, 8:20:20 AM


Login to add comment

Other posts in this group

SymfonyLive Paris 2025 : Reveal of workshop topics!

SymfonyLive Paris 2025, conference in French language only, will take place from March 27 to 28! The schedule is currently being revealed as we go along. More details are available here.

💻

Jan 30, 2025, 8:50:03 AM | Symfony
Get Symfony news on your favorite social network

Symfony has been active on X, Mastodon, and Bluesky for some time, but until recently, not all platforms received equal attention. Since Twitter (now X) was our first social network, all blog posts we

Jan 29, 2025, 2:20:10 PM | Symfony
SymfonyLive Berlin 2025: Demystify the magic of the Container

SymfonyLive Berlin 2025, conference held in English, will take place from April 1 to 4! The schedule is being revealed gradually. More details are available here.

As we are now unveiling th

Jan 29, 2025, 2:20:10 PM | Symfony
Twig CVE-2025-24374: Missing output escaping for the null coalesce operator

Affected versions

Twig versions >=3.16.0,<3.19.0 are affected by this security issue.

The issue has been fixed in Twig 3.19.0.

Description

When using the null coalesce operator (??), output esc

Jan 29, 2025, 9:40:06 AM | Symfony
Symfony 6.4.18 released

Symfony 6.4.18 has just been released. Here is the list of the most important changes since 6.4.17:

bug #58889 [Serializer] Handle default context in Serializer (@Valmonzo)

bug #59631 [HttpClient

Jan 29, 2025, 9:40:05 AM | Symfony
Symfony 7.1.11 released

Symfony 7.1.11 has just been released. Here is the list of the most important changes since 7.1.10:

bug #58889 [Serializer] Handle default context in Serializer (@Valmonzo)

bug #59631 [HttpClient

Jan 29, 2025, 9:40:05 AM | Symfony
Symfony 7.2.3 released

Symfony 7.2.3 has just been released. Here is the list of the most important changes since 7.2.2:

bug #58889 [Serializer] Handle default context in Serializer (@Valmonzo)

bug #59631 [HttpClient]

Jan 29, 2025, 9:40:04 AM | Symfony