Laravel 10如何在不修改配置的情况下动态更改SMTP参数

你之前尝试添加X-SMTP-*自定义头的方式无效，原因是这类头仅作为邮件的附加元数据存在，Laravel/Symfony Mailer不会用它们来配置SMTP传输通道。以下是两种可行方案，适配Web和队列场景：

方案一：动态创建独立SMTP传输器（推荐） #

直接构建Symfony Mailer的SMTP传输实例，无需修改全局配置，每次发送都是独立的传输会话，适合单次邮件发送场景。

use Illuminate\Support\Facades\Mail;
use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;

// 获取用户自定义SMTP配置
$configuration = $this->configuration();
$customer = Customer::find(1);

// 初始化SMTP传输器
$transport = new EsmtpTransport(
    $configuration['smtp_host'],
    (int)$configuration['smtp_port'],
    $configuration['smtp_encryption'] ?? null // 可选，如tls/ssl，null则不加密
);
$transport->setUsername($configuration['smtp_username']);
$transport->setPassword($configuration['smtp_password']);

// 为当前邮件发送绑定自定义传输器
$customMailer = Mail::mailer()->setSymfonyTransport($transport);

// 发送邮件，同时设置发件人信息
$customMailer->send(
    new CustomerMail(
        $customer,
        "Message",
        $configuration['smtp_from_email'],
        $configuration['smtp_from_name']
    ),
    function ($message) use ($configuration) {
        $message->from($configuration['smtp_from_email'], $configuration['smtp_from_name']);
    }
);

方案二：临时覆盖邮件器配置（适合复用场景） #

先在config/mail.php中定义一个动态邮件器模板，发送时临时覆盖其配置参数：

1. 添加配置模板 #

在config/mail.php的mailers数组中新增：

'dynamic_smtp' => [
    'transport' => 'smtp',
    'host' => env('MAIL_HOST'),
    'port' => env('MAIL_PORT'),
    'encryption' => env('MAIL_ENCRYPTION'),
    'username' => env('MAIL_USERNAME'),
    'password' => env('MAIL_PASSWORD'),
    'timeout' => null,
    'auth_mode' => null,
],

2. 动态发送代码 #

use Illuminate\Support\Facades\Config;
use Illuminate\Support\Facades\Mail;

$configuration = $this->configuration();
$customer = Customer::find(1);

// 临时覆盖动态邮件器的配置
Config::set('mail.mailers.dynamic_smtp.host', $configuration['smtp_host']);
Config::set('mail.mailers.dynamic_smtp.port', $configuration['smtp_port']);
Config::set('mail.mailers.dynamic_smtp.encryption', $configuration['smtp_encryption']);
Config::set('mail.mailers.dynamic_smtp.username', $configuration['smtp_username']);
Config::set('mail.mailers.dynamic_smtp.password', $configuration['smtp_password']);

// 使用动态邮件器发送邮件
Mail::mailer('dynamic_smtp')->send(
    new CustomerMail(
        $customer,
        "Message",
        $configuration['smtp_from_email'],
        $configuration['smtp_from_name']
    ),
    function ($message) use ($configuration) {
        $message->from($configuration['smtp_from_email'], $configuration['smtp_from_name']);
    }
);

队列场景适配 #

队列任务运行在独立进程中，全局配置不会保留，需将SMTP配置作为参数传入任务，在任务内部重新构建传输器：

1. 定义队列任务 #

namespace App\Jobs;

use App\Models\Customer;
use App\Mail\CustomerMail;
use Illuminate\Bus\Queueable;
use Illuminate\Support\Facades\Mail;
use Illuminate\Queue\SerializesModels;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use Symfony\Component\Mailer\Transport\Smtp\EsmtpTransport;

class SendCustomerEmail implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    protected $customer;
    protected $message;
    protected $smtpConfig;

    public function __construct(Customer $customer, string $message, array $smtpConfig)
    {
        $this->customer = $customer;
        $this->message = $message;
        $this->smtpConfig = $smtpConfig;
    }

    public function handle()
    {
        // 构建传输器
        $transport = new EsmtpTransport(
            $this->smtpConfig['smtp_host'],
            (int)$this->smtpConfig['smtp_port'],
            $this->smtpConfig['smtp_encryption'] ?? null
        );
        $transport->setUsername($this->smtpConfig['smtp_username']);
        $transport->setPassword($this->smtpConfig['smtp_password']);

        // 发送邮件
        $customMailer = Mail::mailer()->setSymfonyTransport($transport);
        $customMailer->send(
            new CustomerMail(
                $this->customer,
                $this->message,
                $this->smtpConfig['smtp_from_email'],
                $this->smtpConfig['smtp_from_name']
            ),
            function ($message) {
                $message->from($this->smtpConfig['smtp_from_email'], $this->smtpConfig['smtp_from_name']);
            }
        );
    }
}

2. 分发队列任务 #

use App\Jobs\SendCustomerEmail;

$configuration = $this->configuration();
$customer = Customer::find(1);

dispatch(new SendCustomerEmail($customer, "Message", $configuration));

内容的提问来源于stack exchange，提问作者Mukesh Khatri