Download the PHP package devlab-studio/laravel-mailer without Composer

Laravel Mailer

Laravel package for advanced email sending with support for multiple SMTP senders, email logging and attachment management.

Summary

• Registers a custom channel to send notifications via SMTP configured per sender.
• Persists sent emails (body, metadata, status) and attachments to the database and storage (storage/app/attachments/...).
• Allows configuring SMTP senders via an interactive command or using .env and a seeder.

Installation

Install via Composer:

Publish configuration (if applicable) and run migrations:

SMTP Configuration (.env)

Before using the package, fill in your SMTP credentials in .env or use the interactive command:

• MAIL_MAILER=smtp
• MAIL_HOST=your.smtp.host
• MAIL_PORT=587
• [email protected]
• MAIL_PASSWORD=secret
• MAIL_ENCRYPTION=tls # tls, ssl or null
• [email protected]
• MAIL_FROM_NAME="Your Name"

Or run the interactive setup (it will save runtime config and run the seeder):

The command will ask for host, port, protocol, user, password, sender address and name and will run EmailSendersTableSeeder.

Senders Seeder

The EmailSendersTableSeeder inserts a sender into the email_senders table using current mail configuration (normally from .env). Run it manually:

File: database/seeders/EmailSendersTableSeeder.php

Custom channel and send flow

The main channel is CustomMailChannel (src/CustomMail/CustomMailChannel.php) and does the following:

• Retrieves the recipient from the notifiable. Supports AnonymousNotifiable.
• Resolves the sender (from) from the message or from config (devlab.MAIL_FROM_ADDRESS).
• Logs the email in the emails table storing HTML body, subject, to/cc/bcc and metadata.
• Stores attachments in storage/app/attachments/YYYY/M/D/ and creates records in emails_attachments.
• Selects which mailer to use by querying email_senders table:
  • If the sender exists, it dynamically creates a mailer custom{ID} with the sender credentials (password decrypted) and uses it.
  • Otherwise it falls back to the default smtp mailer.
• Sends the message using the selected mailer and updates the email record with status, sent date and errors if any.

Key files:

• src/CustomMail/CustomMailChannel.php
• src/Models/Email.php (logging and filters)
• src/Models/EmailsAttachment.php (attachment metadata)
• src/Models/EmailSender.php (SMTP senders)

Database structure

The package includes migrations in database/migrations to create:

• email_senders — SMTP senders and credentials (password encrypted)
• emails — records of sent emails (body, status, to/cc/bcc, sent_at, etc.)
• emails_attachments — attachment metadata and storage paths

Check database/migrations for exact columns.

Attachments storage

Physical attachments are copied to storage/app/attachments/{year}/{month}/{day}/ and the path is recorded in the DB. The channel supports:

• Illuminate\\Mail\\Attachment
• Illuminate\\Http\\UploadedFile
• Disk paths (strings)

Usage (quick example)

Inside a notification, implement toCustomMail() and return a Mailable or MailMessage with attachments and rawAttachments when needed. When notifying, the package:

Errors and logging

On exception during sending, the channel captures the error, stores it on the email record and writes to the application log:

• Look for logs with Log::error('CustomMailChannel error: ...')

Best practices & security

• Ensure SMTP credentials stored in the database are encrypted (the seeder uses encrypt() during insert).
• Protect access to email_senders if users can modify senders.

Useful commands

Package entry file

The service provider registers config, migrations and the command:

• src/LaravelMailerServiceProvider.php

Support

• Site: https://dev-lab.es/contact

© 2026 Devlab Studio