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

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

關鍵要點：

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

Laravel 提供了許多實用功能，其中包括郵件發(fā)送功能。您可以輕松配置并通過多種流行服務發(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 視圖向網站上的新注冊用戶發(fā)送電子郵件。使用 Laravel 5.3 中的 Mailable，它變得更加簡單（但舊語法仍然有效）。

以下是一個示例：

# 生成一個新的可郵件類
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 還提供了一個良好的起點，用于在開發(fā)階段使用日志驅動程序發(fā)送郵件，在生產階段使用 smtp、sparkpost、mailgun 等。在大多數情況下，這似乎很好，但它無法涵蓋所有可用的服務！在本教程中，我們將學習如何擴展現有的郵件驅動程序系統(tǒng)以添加我們自己的驅動程序。

為了使我們的示例簡單明了，我們將郵件日志記錄到數據庫表中。

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

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

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)建一個新的類。如果您熟悉 Laravel 服務提供程序，您將知道我們擴展了 ServiceProvider 類并定義了 boot 和 register 方法。您可以在文檔中閱讀更多關于提供程序的信息。

使用郵件提供程序

與其使用父服務提供程序類，我們可以采取捷徑并擴展現有的 IlluminateMailMailServiceProvider。這意味著 register 方法已實現。

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

registerSwiftMailer 方法將根據 mail.driver 配置值返回相應的傳輸驅動程序。我們在這里可以做的是在調用 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 實例，它應該返回 Swift_Mailer 的 SwiftMailer 實例。我們需要將我們的 Swift mailer 實例綁定到容器。

// routes/web.php

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

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

    return "done";
});

您可以將傳輸對象視為實際的驅動程序。如果您檢查 IlluminateMailTransport 命名空間，您會發(fā)現每個驅動程序的不同傳輸類（例如：LogTransport、SparkPostTransport 等）。

Swift_Mailer 類需要一個 Swift_Transport 實例，我們可以通過擴展 IlluminateMailTransportTransport 類來滿足它。它應該看起來像這樣。

php artisan make:provider DBMailProvider

我們應該在這里實現的唯一方法是 send 方法。它負責郵件發(fā)送邏輯，在這種情況下，它應該將我們的電子郵件記錄到數據庫中。至于我們的構造函數，我們目前可以將其留空，因為我們不需要任何外部依賴項。

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

將電子郵件記錄到數據庫

下一步是為我們的數據庫表創(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();
    }
}

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

現在，我們需要創(chuàng)建一個新的模型來與我們的表交互，并將必要的字段添加到 fillable 數組中。

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

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

發(fā)送電子郵件

好的，現在是時候測試我們到目前為止所取得的成果了。我們首先將我們的提供程序添加到 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');
    }
}

然后我們將郵件驅動程序注冊到 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ā)送測試電子郵件并檢查它是否被記錄到數據庫中。我將在訪問主頁 URL 時發(fā)送電子郵件。以下是代碼。

php artisan make:provider DBMailProvider

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

結論

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

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

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

如何擴展 Laravel 5.3 中的郵件驅動程序？

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

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

Laravel 中的郵件日志記錄是一個允許您跟蹤應用程序發(fā)送的所有傳出電子郵件的功能。這對于調試非常有用，因為它允許您準確查看正在發(fā)送哪些電子郵件、何時發(fā)送以及發(fā)送給誰。它也對審計非常有用，因為它提供了應用程序發(fā)送的所有電子郵件通信的記錄。

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

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

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

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

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

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

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

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

以上是Laravel 5.3中的郵件記錄：擴展郵件驅動程序的詳細內容。更多信息請關注PHP中文網其他相關文章！