Laravel 9.x：如何在控制器间安全传递变量并注入邮件类-php教程-PHP中文网

Laravel 9.x：如何在控制器间安全传递变量并注入邮件类

本文详解如何将表单数据从 pagescontroller 传递至自定义邮件类 helloemail，通过构造函数注入实现变量解耦，避免“undefined variable”错误，并确保邮件发送逻辑清晰、可维护。

本文详解如何将表单数据从 pagescontroller 传递至自定义邮件类 helloemail，通过构造函数注入实现变量解耦，避免“undefined variable”错误，并确保邮件发送逻辑清晰、可维护。

在 Laravel 9.x 中，直接在邮件类（如 HelloEmail）中访问控制器作用域内的变量（如 $emailSender）会导致 Undefined variable 错误——因为邮件类是独立实例化、无上下文关联的。正确做法是通过构造函数显式接收并保存所需参数，实现依赖注入与职责分离。

✅ 正确实现步骤

1. 修改 HelloEmail 邮件类：支持参数注入

<?php namespace App\Mail;

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

class HelloEmail extends Mailable implements ShouldQueue
{
    use Queueable, SerializesModels;

    public string $emailSender;
    public string $emailSubject;
    public string $emailBody;

    // 构造函数接收并绑定外部传入的变量
    public function __construct(string $emailSender, string $emailSubject, string $emailBody)
    {
        $this->emailSender = $emailSender;
        $this->emailSubject = $emailSubject;
        $this->emailBody = $emailBody;
    }

    public function build()
    {
        return $this->from($this->emailSender)
                    ->subject($this->emailSubject)  // 注意：subject() 接收主题，不是 body()
                    ->text('emails.hello')           // 推荐使用视图模板（见下方说明）
                    ->with([
                        'body' => $this->emailBody,
                    ]);
    }
}

⚠️ 注意事项：

->body() 方法仅用于纯文本内容（已弃用），Laravel 9+ 推荐使用 ->text() 或 ->html() 指向 Blade 视图；

->subject() 设置邮件标题，->from() 设置发件人，二者参数不可互换；

若需富文本内容，请创建 resources/views/emails/hello.blade.php 并在其中使用 {{ $body }} 渲染。

2. 更新 PagesController：接收表单并触发邮件发送（推荐重定向 + Session 闪存，或直接调用）

由于当前路由 /message 是 POST，而 /send-email 是独立 GET 请求，二者无数据关联。不建议分两步跳转传递敏感表单数据（易丢失、不安全）。更合理的方式是：

✅ 方案一（推荐）：在 getData() 中直接发送邮件

// app/Http/Controllers/PagesController.php
public function getData(Request $request)
{
    $validated = $request->validate([
        'emailSender'   => ['required', 'email'],
        'emailSubject'  => ['required', 'string', 'max:255'],
        'emailBody'     => ['required', 'string'],
    ]);

    $toAddress = 'recipient@example.com';

    \Mail::to($toAddress)->send(
        new HelloEmail(
            $validated['emailSender'],
            $validated['emailSubject'],
            $validated['emailBody']
        )
    );

    return back()->with('status', '邮件已成功发送！');
}

✅ 方案二（若需复用 EmailController）：将数据通过请求参数或 session 透传

// 在 PagesController@getData 中：
return redirect()->route('send.email')->with([
    'emailSender'   => $request->input('emailSender'),
    'emailSubject'  => $request->input('emailSubject'),
    'emailBody'     => $request->input('emailBody'),
]);

对应更新 EmailController@sendEmail：

public function sendEmail(Request $request)
{
    $data = $request->session()->pull('emailSender') 
        ?? session()->only(['emailSender', 'emailSubject', 'emailBody']);

    if (empty($data['emailSender'])) {
        abort(400, '缺少必要邮件参数');
    }

    Mail::to('recipient@example.com')->send(
        new HelloEmail(
            $data['emailSender'],
            $data['emailSubject'] ?? '无主题',
            $data['emailBody'] ?? '无内容'
        )
    );

    return response()->json(['message' => '邮件已发送']);
}

3. 路由优化（可选但推荐）

移除冗余的 GET /send-email，统一由表单提交处理：

// routes/web.php
Route::post('/message', [PagesController::class, 'getData'])->name('message.send');
Route::view('/message', 'message')->name('message.form');