Laravel 9实现发送前让用户修改Mailable邮件内容的方案咨询

1. 构建可自定义内容的抽象Mailable基类 #

先创建一个抽象基类，统一处理「自定义内容优先」的逻辑，所有业务邮件类都继承这个基类，避免重复代码：

<?php

namespace App\Mail;

use Illuminate\Mail\Mailable;

abstract class CustomizableMailable extends Mailable
{
    // 存储用户修改后的HTML内容
    protected ?string $customHtml = null;

    // 设置自定义内容的方法
    public function setCustomHtml(?string $html): self
    {
        $this->customHtml = $html;
        return $this;
    }

    // 重写build方法，优先使用自定义内容
    public function build()
    {
        if ($this->customHtml) {
            // 直接加载用户修改后的HTML
            return $this->html($this->customHtml);
        }

        // 无自定义内容时，调用子类的原始内容生成逻辑
        return $this->buildOriginal();
    }

    // 子类必须实现，用于生成原始邮件内容
    abstract protected function buildOriginal();
}

2. 为每个模板创建独立的业务Mailable类 #

比如订单确认邮件，继承上面的抽象类，专注实现原始内容的生成逻辑（从数据库取数、绑定模板）：

<?php

namespace App\Mail;

use App\Models\Order;
use Illuminate\Bus\Queueable;
use Illuminate\Queue\SerializesModels;

class OrderConfirmationMail extends CustomizableMailable
{
    use Queueable, SerializesModels;

    public Order $order;

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

    // 生成原始邮件内容的核心逻辑
    protected function buildOriginal()
    {
        return $this->view('emails.order.confirmation')
            ->subject('您的订单确认通知')
            ->with([
                'orderNumber' => $this->order->number,
                'totalAmount' => $this->order->total_amount,
                // 其他从数据库获取的变量
            ]);
    }
}

3. 预览与修改流程实现 #

步骤1：生成原始内容供用户预览 #

在控制器中实例化对应Mailable，调用buildOriginal()生成原始HTML，传递给预览修改页面：

public function previewOrderConfirmation(Order $order)
{
    $mail = new OrderConfirmationMail($order);
    // 渲染原始邮件模板得到HTML
    $originalHtml = $mail->buildOriginal()->render();

    return view('emails.preview', [
        'originalHtml' => $originalHtml,
        'mailType' => 'order-confirmation',
        'modelId' => $order->id,
    ]);
}

步骤2：处理用户修改后的内容并发送 #

用户提交修改后的内容后，控制器接收参数，实例化对应Mailable并设置自定义内容，再执行发送：

public function sendCustomizedMail(Request $request)
{
    $request->validate([
        'custom_html' => 'required|string',
        'mail_type' => 'required|string',
        'model_id' => 'required|integer',
    ]);

    // 根据邮件类型匹配对应的Mailable类
    $mail = match ($request->mail_type) {
        'order-confirmation' => new OrderConfirmationMail(Order::findOrFail($request->model_id)),
        'user-welcome' => new UserWelcomeMail(User::findOrFail($request->model_id)),
        // 扩展其他邮件类型
        default => abort(400, '无效的邮件类型'),
    };

    // 注入用户修改后的内容
    $mail->setCustomHtml($request->custom_html);

    // 执行发送（替换为实际收件人）
    Mail::to('user@example.com')->send($mail);

    return redirect()->back()->with('success', '邮件已发送');
}

步骤3：预览修改页面的Blade模板 #

提供富文本编辑器（如TinyMCE）让用户修改HTML内容：

<form action="{{ route('send-customized-mail') }}" method="POST">
    @csrf
    <input type="hidden" name="mail_type" value="{{ $mailType }}">
    <input type="hidden" name="model_id" value="{{ $modelId }}">

    <textarea name="custom_html" id="mail-editor" rows="20">{{ $originalHtml }}</textarea>

    <button type="submit" class="btn btn-primary">发送修改后的邮件</button>
</form>

<script src="https://cdn.tiny.cloud/1/你的API密钥/tinymce/6/tinymce.min.js" referrerpolicy="origin"></script>
<script>
    tinymce.init({
        selector: '#mail-editor',
        plugins: 'advlist autolink lists link image charmap print preview',
        toolbar: 'undo redo | formatselect | bold italic | alignleft aligncenter | bullist numlist | removeformat'
    });
</script>

核心优势 #

• 职责分离：每个邮件模板对应独立Mailable类，专注原始内容生成；基类统一处理自定义内容逻辑，避免重复代码。
• 灵活切换：有自定义内容时优先使用，无则自动 fallback 到原始模板，完全兼容原有发送逻辑。
• Laravel 9.x 兼容：基于官方Mailable的html()方法和模板渲染机制，无版本兼容问题。

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