Download the PHP package draw/post-office-bundle without Composer
On this page you can find all versions of the php package draw/post-office-bundle. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Informations about the package post-office-bundle
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 allow to delegate creation of email to a specific class.
It also allow 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\Bundle\PostOfficeBundle\Email\EmailWriterInterface will be register 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 it's 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 a Email folder in which you will create all your email class and also your writer class that does implement the Draw\Bundle\PostOfficeBundle\Email\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 you 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\Bundle\PostOfficeBundle\Email\DefaultFromEmailWriter you will see how to create a writer that is call for all the email that are sent.
All versions of post-office-bundle with dependencies
symfony/css-selector Version ^4.4 || ^5.4
symfony/dom-crawler Version ^4.4 || ^5.4
symfony/framework-bundle Version ^4.4 || ^5.4
symfony/mailer Version ^4.4 || ^5.4
symfony/translation Version ^4.4 || ^5.4