wexample / symfony-mail

4.0.4 2026-10-29 13:29 UTC

Requires

• php: >=8.5
• doctrine/doctrine-bundle: ^2.13 || ^3.0
• doctrine/orm: ^3.0
• symfony/mailer: ^7.4
• symfony/mime: ^7.4 || ^8.0
• symfony/twig-bridge: ^7.4
• wexample/symfony-helpers: >=19.1.0
• wexample/symfony-loader: >=26.1.0
• wexample/symfony-translations: >=17.0.1

Requires (Dev)

• phpunit/phpunit: ^13
• wexample/symfony-testing: >=2.0.0

MIT

• weeger

Published on Packagist.org on 2026-10-29 13:34 UTC

README

Version: 4.0.4

Mails for Symfony: a sender every mail goes through, and a development mailbox

Table of Contents

• Installation
• Introduction

Installation

// config/bundles.php
Wexample\SymfonyMail\WexampleSymfonyMailBundle::class => ['all' => true],

The sender

Every mail leaves from the mailer's sender unless it names its own:

# config/packages/mailer.yaml
framework:
    mailer:
        dsn: '%env(MAILER_DSN)%'
        headers:
            From: '%env(MAILER_FROM)%'

MAILER_FROM='App <[e-mail]>'

Both are requirements symfony-loader checks (loader:requirements): without them the transport refuses each mail, in a worker, long after.

Development mailbox

# .env.dev
MAILER_DSN=mailbox://default

Every mail is then kept in var/mailbox instead of being sent: its raw source as <id>.eml, and a summary as <id>.json. The directory is set by wexample_symfony_mail.mailbox.directory.

The transport is refused in prod: a mail kept on disk is a mail its recipient never gets. The refusal is raised when the mailer first creates its transport, at the first send.

Introduction

Mails for Symfony applications:

• MailSenderService, the sender every mail of an application goes through: texts beside the template, a layout, a text part that keeps its links, the recipient's locale, and no rendered mail in a queue or a log (see usage/sending);
• a development mailbox, where every mail lands instead of leaving the machine, readable by a page (symfony-mail-ds), a console command and the application's tests.