Download the PHP package draw/mailer without Composer

DrawPostOfficeBundle

Be since the Symfony/Mailer is not completed yet some behavior may be affected in later release, consider this bundle as experimental too

This bundle allows to delegate creation of email to a specific class.

It also allows configuration for a default from.

Configuration

Instead of building your email in your controller directly you create a class that extend from the Symfony\Component\Mime\Email and create a writer for it.

Any service that implement the Draw\Component\Mailer\EmailWriter\EmailWriterInterface will be registered as a writer. The getForEmails must return a map of method with priority as the value to register method as a writer (if you return the method as the value it will consider is priority to be 0). The system will detect if the email match the class of the first argument of the method and call it if needed.

The Post Office declare a listener for Symfony\Component\Mailer\Event\MessageEvent to hook it to the symfony mailer.

By convention, it's recommend to create an Email folder in which you will create all your email class and also a EmailWriter for your class that does implement the Draw\Component\Mailer\EmailWriter\EmailWriterInterface.

Example

Let's create a forgot password email, this class will contain the minimum information to compose the email, in that case the email of the user that trigger the forgot password email flow.

We must create a writer for the email:

The basic controller example:

That way you keep your controller clean and structure how email should be written and overridden.

The system also pass the Envelope parameter as the second argument in case you need it.

If you look at the Draw\Component\Mailer\EmailWriter\DefaultFromEmailWriter you will see how to create a writer that is call for all the email that are sent.