README

Laravel Mail driver for sending emails through your self-hosted Mail Proxy.

Requirements

• PHP 8.1+
• Laravel 10, 11, or 12

Installation

composer require pandawa/mailproxy-laravel

The service provider is auto-discovered by Laravel.

Configuration

1. Add the mailer to config/mail.php

'mailers' => [
    // ...existing mailers...

    'mail-proxy' => [
        'transport' => 'mail-proxy',
        'endpoint' => env('MAIL_PROXY_ENDPOINT'),
        'api_key' => env('MAIL_PROXY_API_KEY'),
        'timeout' => env('MAIL_PROXY_TIMEOUT', 30),
        'from_address' => env('MAIL_FROM_ADDRESS'),
        'from_name' => env('MAIL_FROM_NAME'),
    ],
],

2. Set environment variables in .env

MAIL_MAILER=mail-proxy
MAIL_PROXY_ENDPOINT=http://localhost:9501
MAIL_PROXY_API_KEY=your-api-key-here
MAIL_FROM_ADDRESS=noreply@example.com
MAIL_FROM_NAME="App Name"

Usage

Once configured, use Laravel's Mail facade as usual:

use Illuminate\Support\Facades\Mail;
use App\Mail\WelcomeEmail;

Mail::to('user@example.com')->send(new WelcomeEmail());

Attachments, CC, BCC, HTML and plain text bodies are all supported.

License

MIT