Laravel 8中如何使用表单提交的SMTP配置替代配置文件邮件配置

原生Mailable类不支持你写的smtp()、port()这类链式配置SMTP参数的方法，你需要在发送邮件前手动创建自定义SMTP传输实例，不需要读取config/mail.php或者.env的固定配置，实现方式如下：

第一步：编写标准Mailable类 #

仅在build方法中处理邮件内容、发件人、主题等业务配置即可：

<?php

namespace App\Mail;

use Illuminate\Bus\Queueable;
use Illuminate\Mail\Mailable;
use Illuminate\Queue\SerializesModels;

class CustomSmtpMail extends Mailable
{
    use Queueable, SerializesModels;

    // 传入的邮件业务数据
    public $mailData;

    public function __construct($mailData)
    {
        $this->mailData = $mailData;
    }

    public function build()
    {
        return $this->from($this->mailData['from_address'], $this->mailData['from_name'])
                    ->subject($this->mailData['subject'])
                    ->view('mail.view')
                    ->with(['message' => $this->mailData['content']]);
    }
}

第二步：调用发送前动态创建SMTP传输实例 #

在你接收表单参数的控制器方法中，用表单提交的SMTP配置创建独立的邮件发送实例，和全局配置完全隔离：

<?php

namespace App\Http\Controllers;

use App\Mail\CustomSmtpMail;
use Illuminate\Http\Request;
use Mail;
use Swift_Mailer;
use Swift_SmtpTransport;

class MailSendController extends Controller
{
    public function send(Request $request)
    {
        // 校验表单提交的SMTP配置和邮件内容
        $validated = $request->validate([
            // SMTP配置参数
            'smtp_host' => 'required|string',
            'smtp_port' => 'required|integer',
            'smtp_username' => 'required|string',
            'smtp_password' => 'required|string',
            'smtp_encryption' => 'nullable|string|in:tls,ssl',
            // 邮件业务参数
            'from_address' => 'required|email',
            'from_name' => 'required|string',
            'to_email' => 'required|email',
            'subject' => 'required|string',
            'content' => 'required|string',
        ]);

        // 1. 用表单配置创建独立的SMTP传输对象
        $transport = new Swift_SmtpTransport(
            $validated['smtp_host'],
            $validated['smtp_port'],
            $validated['smtp_encryption']
        );
        $transport->setUsername($validated['smtp_username']);
        $transport->setPassword($validated['smtp_password']);

        // 2. 生成自定义的邮件发送实例
        $customMailer = new Swift_Mailer($transport);

        // 3. 临时替换Mail门面的发送实例
        Mail::setSwiftMailer($customMailer);

        try {
            // 正常发送邮件即可，走自定义的SMTP配置
            Mail::to($validated['to_email'])->send(new CustomSmtpMail($validated));
            return '邮件发送成功';
        } catch (\Exception $e) {
            return '邮件发送失败：' . $e->getMessage();
        } finally {
            // 可选：发送完成后重置为全局默认邮件配置，避免影响当前请求后续其他邮件发送逻辑
            Mail::swap(app('mailer'));
        }
    }
}

注意事项 #

• 不要通过config()方法动态修改mail配置项，Laravel的配置是全局共享的，并发请求下会出现配置串用的问题，上面的独立创建Swift_Mailer实例的方式是线程安全的，不同请求的配置互不影响。
• 如果需要使用队列发送邮件，不要使用上面的临时注入方式，需要把SMTP配置序列化到队列任务中，在任务执行时再创建自定义传输实例发送，否则队列执行时会读取全局默认配置，不会用你临时注入的配置。
• 表单提交的SMTP密码属于敏感信息，不要明文存储到日志、数据库中，需要暂存的话请做好加密处理。

内容的提问来源于stack exchange，提问作者ismail andaloussi