Laravel Mailbox

Laravel Mailbox

Laravel Mailbox is a package by Marcel Pociot for handling incoming emails in your Laravel application. Mailbox features a fluent API that allows you to define custom mailboxes to catch incoming emails.

Here’s a quick example of an inbound email handler from the documentation:

Mailbox::from('{username}@gmail.com', function (InboundEmail $email, $username) {
    // Access email attributes and content
    $subject = $email->subject();

    $email->reply(new ReplyMailable);
});

Laravel Mailbox works by listening for incoming emails from the supported drivers (options include “mailgun,” “sendgrid,” and “log”) and then responding to them through custom mailbox classes. At a basic level, here’s an example of how you can define a mailbox in a service provider:

use BeyondCode\Mailbox\Facades\Mailbox;

class AppServiceProvider extends ServiceProvider
{
    /**
     * Bootstrap any application services.
     *
     * @return void
     */
    public function boot()
    {
        Mailbox::from('sender@domain.com', function (InboundEmail $email) {
            // Handle the incoming email
        });
    }
}

The above example uses a closure, but the second argument can also be an invocable class:

Mailbox::from('sender@domain.com', MyMailbox::class);

By default, this package stores all inbound emails in the database, with a configurable duration to keep them. You can use Laravel’s scheduler with the package’s ‘mailbox:clean’ command, which will remove emails from the database older than the configurable duration to keep them. Check the storing emails documentation for further details.

Out of the box, Mailbox supports Mailgun, Sendgrid, and a local development driver/log. However, you can easily extend/add custom drivers—Laravel Mailbox uses the same manager pattern that is familiar to Laravel users (i.e., database drivers).

To learn more about Laravel Mailbox, you can check out the source code on GitHub at beyondcode/laravel-mailbox. To learn how to install and use the package, check out the Laravel Mailbox documentation.


Filed in: News / packages


Newsletter

Join the weekly newsletter and never miss out on new tips, tutorials, and more.

Laravel News Partners

Laravel Jobs

PHP Web Developer
Orlando, FL
Christ for all Nations
PHP Developer
Manhattan, KS (open to Remote)
CivicPlus
Mid-Senior Laravel Developer
Exeter
Optix Solutions
Full Stack Web Developer
Las Vegas, NV
V Shred
Staff Software Engineer (Laravel)
Remote
smartbnb
Software Engineer (PHP, Laravel, Vue)
Los Angeles, CA
Relocity
Software Engineer Level 1 / Level 2
St. Pete. / Tampa Area, FL / Remote
ShineOn