fusonic / php-messenger-mailer-bundle

messenger-mailer-bundle

• About
• Install
• Usage
• Contributing

About

You might need to bundle if your project fulfills the following criteria:

• You are using Symfony Mailer with Symfony Messenger.
• Your message queue containing the Mailer messages is running asynchronously.
• Your email contains attachments.

This bundle solves the following problems that can occur:

• If you use Symfony\Component\Mime\Email::attach the message will contain the entire file. Using blob data inside the message transport is not recommended and can lead to problems.
• If you use Symfony\Component\Mime\Email::attachFromPath, the path might not exist at the moment of handling the message (depending on your implementation). An example is when you are generating a temporary file (such as a PDF) and want to attach it to the e-mail. If this is a temporary file it might get deleted before the message is handled.

Install

Use composer to install the bundle from packagist.

composer require fusonic/messenger-mailer-bundle

Requirements:

• PHP 8.0+
• Symfony 5.2+

In case Symfony did not add the bundle to the bundle configuration, add the following (by default located in config/bundles.php):

<?php

return [
    // ...
    Fusonic\MessengerMailerBundle\MessengerMailerBundle::class => ['all' => true],
];

Configuration (optional)

Out of the box, no configuration is required at all. The following configuration is the default:

# Bundle configuration
messenger_mailer:
    # Use the included filesystem implementation or implement your own service
    # by implementing the `Fusonic\MessengerMailerBundle\Contracts\EmailAttachmentHandlerInterface` interface.
    attachment_handler: Fusonic\MessengerMailerBundle\EmailAttachmentHandler\FilesystemAttachmentHandler

services:
    # Configure the services used as the `attachment_handler` above.
    Fusonic\MessengerMailerBundle\EmailAttachmentHandler\FilesystemAttachmentHandler:
        arguments:
            $attachmentsDirectory: "%kernel.project_dir%/var/email-attachments"

If you want to use a different service for attachment handling, you can create your own and overwrite the default in your service configuration.

Usage

This bundle provides two classes for creating e-mails AttachmentEmail (extension of the Symfony Email class) and TemplatedAttachmentEmail (extension of the Symfony TemplatedEmail class).

Instead of using attach and attachFromPath you should use attachPersistedFromPath and attachPersisted. Both of these methods will persist the content depending on the FilesystemAttachmentHandler.

$email = (new TemplatedAttachmentEmail())
    ->from('[e-mail]')
    ->attachPersisted('Email text', 'filename.txt', 'plain/text')
    // ...
    ->html('...');

Contributing

This is a subtree split of fusonic/php-extensions repository. Please create your pull requests there.