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

A Week of Symfony #967 (July 7–13, 2025)

This week, Symfony unveiled the Symfony AI initiative, a set of components and bundles designed to bring powerful AI capabilities directly into your PHP applications. In addition, we published travel

Jul 13, 2025, 9:20:11 AM | Symfony
Kicking off the Symfony AI Initiative

Today we are happy to announce a new Symfony initiative called Symfony AI - with the goal to provide a comprehensive set of components and bundles designed to bring powerful AI capabilities directly i

Jul 11, 2025, 1:20:27 PM | Symfony
SymfonyCon Amsterdam 2025: Travel & Lodging Tips

SymfonyCon Amsterdam 2025, our next annual international Symfony conference, will take place on:

November 25 & 26: 2 workshops days with several topics to learn, practice and improve your skills

Jul 11, 2025, 8:40:20 AM | Symfony
A Week of Symfony #966 (June 30 – July 6, 2025)

This week, development on the upcoming Symfony 8.0 version continued with the removal of deprecated features and the marking of several classes as final. In addition, we published two new case studies

Jul 6, 2025, 8:10:15 AM | Symfony
Case study: Modernizing Audi France’s Digital Ecosystem with Symfony 6

At Wide, Micropole’s digital agency, they help leading brands modernize their digital infrastructures while ensuring scalability, security, and performance. When Audi France approached them to migrate

Jul 4, 2025, 9:40:14 AM | Symfony
Case study: A Long-Term Powerhouse Behind Vente-unique.com's E-Commerce Success (Zero Churn, All Wins!)

Vente-unique.com, a leading European online retailer of furniture and home decor, operates in 11 countries, powered by a team of 400 professionals and serving more than 3 million customers. From 15 ye

Jul 2, 2025, 9:10:03 AM | Symfony
A Week of Symfony #965 (June 23–29, 2025)

This week, Symfony 6.4.23, 7.2.8 and 7.3.1 maintenance versions were released. Meanwhile, the upcoming Symfony 7.4 version continued adding new features such as better controller helpers, more precisi

Jun 29, 2025, 9:10:15 AM | Symfony