hakito/cakephp-mailqueue-plugin

Plugin to store mail in a queue for later sendout

CakePHP-Mailqueue-Plugin

, _(*1)

CakePHP 5.x plugin to store mail in a queue for later sendout., _(*2)

When working with emails on a webservice sending email blocks the http request until the email is actually sent out. This can be frustrating for a user especially if the smtp server does not respond promptly., _(*3)

With this plugin you can save the mail to a local queue file and invoke the actual transport for example with a cron fired cake shell command., _(*4)

Installation

If you are using composer simply add it with:, _(*5)

composer require hakito/cakephp-mailqueue-plugin

Otherwise download the plugin to app/Plugin/Mailqueue., _(*6)

Load the plugin in your bootstrap method, _(*7)

$this->addPlugin('MailQueue');

Configuration

Add a transport entry to your app_local.php, _(*8)

'EmailTransport' => [
    'MailQueue' => [
        // required
        'className' => \MailQueue\Mailer\Transport\QueueTransport::class,
        'queueFolder' => TMP . 'mailqueue', // storage location for mailqueue

        // optional:
        'requeue' => [300, 500, 1000] // requeue after x seconds in case of an error
    ]
],

'Email' => [
    'default' => [
        'transport' => 'MailQueue',
    ],
    'smtp' => [
        // configure your real mailer here
    ]
]

Queue a mail

Send mail to the queue as usually in cake, _(*9)

$mailer = new Mailer('default');
// place your content in $email
$mailer->deliver();

Do the real sendout

Use cake shell to do the real sendout. The shell script requires 2 arguments. The first is the name of your queue configuration and the second the name of the config to use for the real sendout., _(*10)

In your app directory execute:, _(*11)

bin/cake MailQueue SendMail smtp