Laravel 5.3郵件發(fā)送擴(kuò)展：自定義數(shù)據(jù)庫郵件日志

Laravel 5.3 提供了一種簡(jiǎn)單的方法來配置和通過多種流行服務(wù)發(fā)送電子郵件，并包含一個(gè)用于開發(fā)的日志輔助程序。然而，它并不涵蓋所有可用的服務(wù)，因此可能需要擴(kuò)展現(xiàn)有的郵件驅(qū)動(dòng)程序系統(tǒng)。

關(guān)鍵要點(diǎn)：

• Laravel 5.3 提供了通過多種流行服務(wù)輕松配置和發(fā)送電子郵件的簡(jiǎn)便方法，并包含用于開發(fā)的日志輔助程序。但是，它并不涵蓋所有可用的服務(wù)，因此可能需要擴(kuò)展現(xiàn)有的郵件驅(qū)動(dòng)程序系統(tǒng)。
• 要擴(kuò)展郵件驅(qū)動(dòng)程序系統(tǒng)，可以使用 artisan 命令行助手創(chuàng)建一個(gè)新的服務(wù)提供程序。此服務(wù)提供程序在啟動(dòng)時(shí)與應(yīng)用程序交互并注冊(cè)服務(wù)。
• 新的服務(wù)提供程序可以擴(kuò)展現(xiàn)有的 IlluminateMailMailServiceProvider，允許 register 方法已被實(shí)現(xiàn)。這允許創(chuàng)建新的傳輸管理器，該管理器可以將 Swift mailer 實(shí)例綁定到容器。
• 擴(kuò)展的郵件驅(qū)動(dòng)程序系統(tǒng)可用于將電子郵件記錄到數(shù)據(jù)庫表中以進(jìn)行調(diào)試。這是通過為數(shù)據(jù)庫表創(chuàng)建一個(gè)新的遷移和一個(gè)新的模型來與表交互來實(shí)現(xiàn)的。然后將提供程序添加到 config/app.php 文件中的提供程序列表中，并將郵件驅(qū)動(dòng)程序注冊(cè)到 config/mail.php 文件中的 db 中。

Laravel 提供了許多實(shí)用功能，其中包括郵件發(fā)送功能。您可以輕松配置并通過多種流行服務(wù)發(fā)送電子郵件，它甚至包含用于開發(fā)的日志輔助程序。

Mail::send('emails.welcome', ['user' => $user], function ($m) use ($user) {
    $m->to($user->email, $user->name)->subject('Welcome to the website');
});

這將使用 emails.welcome 視圖向網(wǎng)站上的新注冊(cè)用戶發(fā)送電子郵件。使用 Laravel 5.3 中的 Mailable，它變得更加簡(jiǎn)單（但舊語法仍然有效）。

以下是一個(gè)示例：

# 生成一個(gè)新的可郵件類
php artisan make:mail WelcomeMail

// app/Mail/WelcomeMail.php

class WelcomeUser extends Mailable
{
    use Queueable, SerializesModels;

    public $user;

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

    public function build()
    {
        return $this->view('emails.welcome');
    }
}

// routes/web.php

Route::get('/', function () {
    $user = User::find(2);

    \Mail::to($user->email)->send(new WelcomeUser($user));

    return "done";
});

Laravel 還提供了一個(gè)良好的起點(diǎn)，用于在開發(fā)階段使用日志驅(qū)動(dòng)程序發(fā)送郵件，在生產(chǎn)階段使用 smtp、sparkpost、mailgun 等。在大多數(shù)情況下，這似乎很好，但它無法涵蓋所有可用的服務(wù)！在本教程中，我們將學(xué)習(xí)如何擴(kuò)展現(xiàn)有的郵件驅(qū)動(dòng)程序系統(tǒng)以添加我們自己的驅(qū)動(dòng)程序。

為了使我們的示例簡(jiǎn)單明了，我們將郵件日志記錄到數(shù)據(jù)庫表中。

創(chuàng)建服務(wù)提供程序

實(shí)現(xiàn)此目的的首選方法是創(chuàng)建一個(gè)服務(wù)提供程序，以便在啟動(dòng)時(shí)與我們的應(yīng)用程序交互并注冊(cè)我們的服務(wù)。讓我們首先使用 artisan 命令行助手生成一個(gè)新的服務(wù)提供程序。

Mail::send('emails.welcome', ['user' => $user], function ($m) use ($user) {
    $m->to($user->email, $user->name)->subject('Welcome to the website');
});

這將在我們的 app/Providers 文件夾中創(chuàng)建一個(gè)新的類。如果您熟悉 Laravel 服務(wù)提供程序，您將知道我們擴(kuò)展了 ServiceProvider 類并定義了 boot 和 register 方法。您可以在文檔中閱讀更多關(guān)于提供程序的信息。

使用郵件提供程序

與其使用父服務(wù)提供程序類，我們可以采取捷徑并擴(kuò)展現(xiàn)有的 IlluminateMailMailServiceProvider。這意味著 register 方法已實(shí)現(xiàn)。

# 生成一個(gè)新的可郵件類
php artisan make:mail WelcomeMail

registerSwiftMailer 方法將根據(jù) mail.driver 配置值返回相應(yīng)的傳輸驅(qū)動(dòng)程序。我們?cè)谶@里可以做的是在調(diào)用 registerSwiftMailer 父方法之前執(zhí)行檢查并返回我們自己的 傳輸管理器。

// app/Mail/WelcomeMail.php

class WelcomeUser extends Mailable
{
    use Queueable, SerializesModels;

    public $user;

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

    public function build()
    {
        return $this->view('emails.welcome');
    }
}

使用傳輸管理器

Laravel 從 IOC 解析 swift.mailer 實(shí)例，它應(yīng)該返回 Swift_Mailer 的 SwiftMailer 實(shí)例。我們需要將我們的 Swift mailer 實(shí)例綁定到容器。

// routes/web.php

Route::get('/', function () {
    $user = User::find(2);

    \Mail::to($user->email)->send(new WelcomeUser($user));

    return "done";
});

您可以將傳輸對(duì)象視為實(shí)際的驅(qū)動(dòng)程序。如果您檢查 IlluminateMailTransport 命名空間，您會(huì)發(fā)現(xiàn)每個(gè)驅(qū)動(dòng)程序的不同傳輸類（例如：LogTransport、SparkPostTransport 等）。

Swift_Mailer 類需要一個(gè) Swift_Transport 實(shí)例，我們可以通過擴(kuò)展 IlluminateMailTransportTransport 類來滿足它。它應(yīng)該看起來像這樣。

php artisan make:provider DBMailProvider

我們應(yīng)該在這里實(shí)現(xiàn)的唯一方法是 send 方法。它負(fù)責(zé)郵件發(fā)送邏輯，在這種情況下，它應(yīng)該將我們的電子郵件記錄到數(shù)據(jù)庫中。至于我們的構(gòu)造函數(shù)，我們目前可以將其留空，因?yàn)槲覀儾恍枰魏瓮獠恳蕾図?xiàng)。

$message->getTo() 方法始終返回收件人電子郵件和名稱的關(guān)聯(lián)數(shù)組。我們使用 array_keys 函數(shù)獲取電子郵件列表，然后將它們合并以獲取字符串。

將電子郵件記錄到數(shù)據(jù)庫

下一步是為我們的數(shù)據(jù)庫表創(chuàng)建必要的遷移。

// vendor/Illuminate/Mail/MailServiceProvider.php

public function register()
{
    $this->registerSwiftMailer();

    // ...
}

// app/Providers/DBMailProvider.php

function registerSwiftMailer()
{
    if ($this->app['config']['mail.driver'] == 'db') {
        $this->registerDBSwiftMailer();
    } else {
        parent::registerSwiftMailer();
    }
}

我們的遷移只包含電子郵件正文、主題和收件人電子郵件，但您可以根據(jù)需要添加更多詳細(xì)信息。檢查 Swift_Mime_Message 類定義以查看可用字段的列表。

現(xiàn)在，我們需要?jiǎng)?chuàng)建一個(gè)新的模型來與我們的表交互，并將必要的字段添加到 fillable 數(shù)組中。

Mail::send('emails.welcome', ['user' => $user], function ($m) use ($user) {
    $m->to($user->email, $user->name)->subject('Welcome to the website');
});

# 生成一個(gè)新的可郵件類
php artisan make:mail WelcomeMail

發(fā)送電子郵件

好的，現(xiàn)在是時(shí)候測(cè)試我們到目前為止所取得的成果了。我們首先將我們的提供程序添加到 config/app.php 文件中的提供程序列表中。

// app/Mail/WelcomeMail.php

class WelcomeUser extends Mailable
{
    use Queueable, SerializesModels;

    public $user;

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

    public function build()
    {
        return $this->view('emails.welcome');
    }
}

然后我們將郵件驅(qū)動(dòng)程序注冊(cè)到 config/mail.php 文件中的 db 中。

// routes/web.php

Route::get('/', function () {
    $user = User::find(2);

    \Mail::to($user->email)->send(new WelcomeUser($user));

    return "done";
});

唯一剩下的部分是發(fā)送測(cè)試電子郵件并檢查它是否被記錄到數(shù)據(jù)庫中。我將在訪問主頁 URL 時(shí)發(fā)送電子郵件。以下是代碼。

php artisan make:provider DBMailProvider

訪問主頁路由后，我們可以運(yùn)行 php artisan tinker 命令來檢查 emails 表記錄。

結(jié)論

在本文中，我們看到了如何擴(kuò)展郵件驅(qū)動(dòng)程序系統(tǒng)以攔截電子郵件以進(jìn)行調(diào)試。我在 Laravel 中欣賞的一件事是其無與倫比的可擴(kuò)展性：您可以更改或擴(kuò)展從路由器和 IOC 到郵件及其他幾乎所有功能。

如果您有任何問題或意見，請(qǐng)務(wù)必在下面發(fā)表，我會(huì)盡力回答！

關(guān)于 Laravel 5.3 中郵件日志記錄的常見問題解答 (FAQ)

如何擴(kuò)展 Laravel 5.3 中的郵件驅(qū)動(dòng)程序？

擴(kuò)展 Laravel 5.3 中的郵件驅(qū)動(dòng)程序涉及創(chuàng)建新的服務(wù)提供程序。此服務(wù)提供程序?qū)U(kuò)展現(xiàn)有的郵件驅(qū)動(dòng)程序，并允許您添加其他功能。您可以使用 php artisan make:provider 命令創(chuàng)建新的服務(wù)提供程序。創(chuàng)建提供程序后，您可以將其注冊(cè)到 config/app.php 文件中。在提供程序中，您可以使用 extend 方法將自定義功能添加到郵件驅(qū)動(dòng)程序。

Laravel 中郵件日志記錄的目的是什么？

Laravel 中的郵件日志記錄是一個(gè)允許您跟蹤應(yīng)用程序發(fā)送的所有傳出電子郵件的功能。這對(duì)于調(diào)試非常有用，因?yàn)樗试S您準(zhǔn)確查看正在發(fā)送哪些電子郵件、何時(shí)發(fā)送以及發(fā)送給誰。它也對(duì)審計(jì)非常有用，因?yàn)樗峁┝藨?yīng)用程序發(fā)送的所有電子郵件通信的記錄。

如何配置 Laravel 以記錄所有傳出電子郵件？

要配置 Laravel 以記錄所有傳出電子郵件，您需要修改 config/mail.php 文件。在此文件中，您可以將 log 選項(xiàng)設(shè)置為 true。這將指示 Laravel 記錄所有傳出電子郵件。日志將存儲(chǔ)在 storage/logs 目錄中。

如何查看 Laravel 中的郵件日志？

Laravel 中的郵件日志存儲(chǔ)在 storage/logs 目錄中。您可以通過導(dǎo)航到此目錄并打開日志文件來查看這些日志。日志文件根據(jù)日期命名，因此您可以輕松找到特定日期的日志。

我可以自定義 Laravel 中郵件日志的格式嗎？

是的，您可以自定義 Laravel 中郵件日志的格式。這可以通過擴(kuò)展郵件驅(qū)動(dòng)程序并覆蓋 log 方法來完成。在此方法中，您可以指定日志消息的格式。

(其余FAQ與郵件發(fā)送本身相關(guān)，與本例的郵件日志擴(kuò)展無關(guān)，故省略)

請(qǐng)注意，圖片路徑 /uploads/20250210/173915090467a9563807841.webp 和 /uploads/20250210/173915090467a9563839bfc.webp 以及 /uploads/20250210/173915090667a9563a27b41.jpg 需要替換為實(shí)際可訪問的圖片鏈接。

以上是Laravel 5.3中的郵件記錄：擴(kuò)展郵件驅(qū)動(dòng)程序的詳細(xì)內(nèi)容。更多信息請(qǐng)關(guān)注PHP中文網(wǎng)其他相關(guān)文章！