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

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

關鍵要點：

• Laravel 5.3 提供了通過多種流行服務輕松配置和發(fā)送電子郵件的簡便方法，并包含用于開發(fā)的日志輔助程序。但是，它并不涵蓋所有可用的服務，因此可能需要擴展現有的郵件驅動程序系統。
• 要擴展郵件驅動程序系統，可以使用 artisan 命令行助手創(chuàng)建一個新的服務提供程序。此服務提供程序在啟動時與應用程序交互并注冊服務。
• 新的服務提供程序可以擴展現有的 IlluminateMailMailServiceProvider，允許 register 方法已被實現。這允許創(chuàng)建新的傳輸管理器，該管理器可以將 Swift mailer 實例綁定到容器。
• 擴展的郵件驅動程序系統可用于將電子郵件記錄到數據庫表中以進行調試。這是通過為數據庫表創(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 等。在大多數情況下，這似乎很好，但它無法涵蓋所有可用的服務！在本教程中，我們將學習如何擴展現有的郵件驅動程序系統以添加我們自己的驅動程序。

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

創(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() 方法始終返回收件人電子郵件和名稱的關聯數組。我們使用 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 表記錄。

結論

在本文中，我們看到了如何擴展郵件驅動程序系統以攔截電子郵件以進行調試。我在 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中文網其他相關文章！