The Symfony Mailer Queue module extends the existing Drupal Symfony Mailer module by integrating with queue systems to asynchronously send emails.

This enhancement ensures that email delivery is handled asynchronously, significantly improving the performance and reliability of your Drupal site. By utilizing Drupal’s queue system, the module processes email-sending tasks in the background, allowing for better resource management and scalability.

How to use?

Installation: Start by installing the module via Composer. The module depends on Drupal Symfony Mailer.
Configure Queue Settings: Go to Configuration > System > Mailer > Queue and configure maximum retry attempts, re-queue delay, and wait time per item.
Configure Mailer Policies: Go to Configuration > System > Mailer and add the Queue sending email adjuster to the desired policies.
(Optional) Configure Ultimate Cron: If processing the queue with cron, it is recommended to schedule frequent cron processing. This can be achieved with the Ultimate Cron module. There are two jobs to consider:
- The Default cron handler of Symfony Mailer Queue performs garbage collection required to re-queue items.
- The Queue of Symfony Mailer Queue, which sends emails and retries failures.

You can find more details in the blog post Drupal: Asynchronously send emails with Symfony Mailer Queue.

Features

Seamless Integration: It utilizes the existing Drupal Symfony Mailer plugin system and works out of the box with the Drupal database queue.
Queue System: Emails are added to a queue and processed asynchronously, ensuring quick response times for web requests.
Admin Configuration: Easy-to-use configuration interface for managing queue settings.
Event System: Dispatches re-queue and failure events for other modules to subscribe to.

Developer Notes

The queue which processes items is required to implement the DelayableQueueInterface to re-queue items.
The item expiry reset may be performed during cron. In that case, the queue must implement the QueueGarbageCollectionInterface.
Other modules can subscribe to the EmailSendRequeueEvent and EmailSendFailureEvent events to react with logging or further processing. Read this blog post about the Drupal event system.
There is a lot of movement around the mailer setup in Drupal. See the meta issue about including Symfony Mailer in Drupal core. Or the excellent blog series about more advanced setups with Symfony Messenger.

Similar projects

If your website relies on the traditional PHP mailer, explore the Queue Mail or Mail Entity Queue modules.

Sponsored by Factorial GmbH

This project is sponsored by Factorial GmbH. Contact us if you are looking for interesting open-source employment.

Symfony Mailer Queue

Merge Requests

!1Automated Drupal 11 compatibility fixes for symfony_mailer_queueMerged Show issue

Issues

Automated Drupal 11 compatibility fixes for symfony_mailer_queueFixedCode Created 26 days ago

!1Automated Drupal 11 compatibility fixes for symfony_mailer_queue
Merged
Show issue

Automated Drupal 11 compatibility fixes for symfony_mailer_queue
Fixed
Code
Created 26 days ago