[ Laravel 5.2 文档 ] 服务 -- 邮件
1、简介
Laravel基于 SwiftMailer库提供了一套干净清爽的邮件API。Laravel为SMTP、Mailgun、Mandrill、Amazon SES、PHP 的 mail函数，以及 sendmail提供了驱动，从而允许你快速通过本地或云服务发送邮件。
邮件驱动预备知识
基于驱动的 API 如Mailgun 和 Mandrill 通常比 SMTP 服务器更简单、更快。所有的 API 驱动要求应用已经安装 Guzzle HTTP 库。你可以通过添加如下行到 composer.json文件来安装 Guzzle 到项目：
"guzzlehttp/guzzle": "~5.3|~6.0"
Mailgun驱动
要使用 Mailgun 驱动（Mailgun 前10000封邮件免费，后续收费），首先安装 Guzzle，然后在配置文件 config/mail.php中设置 driver选项为 mailgun。接下来，验证配置文件 config/services.php包含如下选项：
'mailgun' => [ 'domain' => 'your-mailgun-domain', 'secret' => 'your-mailgun-key',],
Mandrill驱动
要使用 Mandrill 驱动（Mandrill不支持中国区用户注册，汗！），首先安装 Guzzle，然后在配置文件 config/mail.php中设置 driver选项值为 mandrill。接下来，验证配置文件 config/services.php包含如下选项：
'mandrill' => [ 'secret' => 'your-mandrill-key',],
SES驱动
要使用 Amazon SES 驱动（收费），安装 Amazon AWS 的 PHP SDK，你可以通过添加如下行到 composer.json文件的 require部分来安装该库：
"aws/aws-sdk-php": "~3.0"
接下来，设置配置文件 config/mail.php中的 driver选项为 ses。然后，验证配置文件 config/services.php包含如下选项：
'ses' => [ 'key' => 'your-ses-key', 'secret' => 'your-ses-secret', 'region' => 'ses-region', // e.g. us-east-1],
2、发送邮件
Laravel 允许你在视图中存储邮件信息，例如，要组织你的电子邮件，可以在 resources/views目录下创建 emails目录。
要发送一条信息，使用 Mail 门面上的 send方法。 send方法接收三个参数。第一个参数是包含邮件信息的视图名称；第二个参数是你想要传递到该视图的数组数据；第三个参数是接收消息实例的闭包回调——允许你自定义收件人、主题以及邮件其他方面的信息：
<?phpnamespace App\Http\Controllers;use Mail;use App\User;use Illuminate\Http\Request;use App\Http\Controllers\Controller;class UserController extends Controller{ /** * 发送邮件给用户 * * @param Request $request * @param int $id * @return Response */ public function sendEmailReminder(Request $request, $id) { $user = User::findOrFail($id); Mail::send('emails.reminder', ['user' => $user], function ($m) use ($user) { $m->from('hello@app.com', 'Your Application');$m->to($user->email, $user->name)->subject('Your Reminder!'); }); }}由于我们在上例中传递一个包含 user键的数组，我们可以在邮件中使用如下方式显示用户名：
<?php echo $user->name; ?>
注意： $message变量总是被传递到邮件视图，并允许嵌入附件，因此，你应该在视图负载中避免传入消息变量。
构造消息
正如前面所讨论的，传递给 send方法的第三个参数是一个允许你指定邮件消息本身多个选项的闭包。使用这个闭包可以指定消息的其他属性，例如抄送、群发，等等：
Mail::send('emails.welcome', $data, function ($message) { $message->from('us@example.com', 'Laravel'); $message->to('foo@example.com')->cc('bar@example.com');});下面试 $message消息构建器实例上的可用方法：
$message->from($address, $name = null);$message->sender($address, $name = null);$message->to($address, $name = null);$message->cc($address, $name = null);$message->bcc($address, $name = null);$message->replyTo($address, $name = null);$message->subject($subject);$message->priority($level);$message->attach($pathToFile, array $options = []);// 从$data字符串追加文件...$message->attachData($data, $name, array $options = []);// 获取底层SwiftMailer消息实例...$message->getSwiftMessage();
注意：传递给 Mail::send闭包的消息实例继承自 SwiftMailer消息类，该实例允许你调用该类上的任何方法来构建自己的电子邮件消息。
纯文本邮件
默认情况下，传递给 send方法的视图假定包含HTML，然而，通过传递数组作为第一个参数到 send方法，你可以指定发送除HTML视图之外的纯文本视图：
Mail::send(['html.view', 'text.view'], $data, $callback);
或者，如果你只需要发送纯文本邮件，可以指定在数组中使用text键：
Mail::send(['text' => 'view'], $data, $callback);
原生字符串邮件
如果你想要直接发送原生字符串邮件你可以使用 raw方法：
Mail::raw('Text to e-mail', function ($message) { //});2.1 附件
要添加附件到邮件，使用传递给闭包的 $message对象上的 attach方法。该方法接收文件的绝对路径作为第一个参数：
Mail::send('emails.welcome', $data, function ($message) { // $message->attach($pathToFile);});当添加文件到消息时，你还可以通过传递数组作为第二个参数到 attach方法来指定文件显示名和MIME类型：
$message->attach($pathToFile, ['as' => $display, 'mime' => $mime]);
2.2 内联附件
在邮件视图中嵌入一张图片
嵌套内联图片到邮件中通常是很笨重的，然而，Laravel提供了一个便捷的方式附加图片到邮件并获取相应的CID，要嵌入内联图片，在邮件视图中使用 $message变量上的 embed方法。记住，Laravel自动在所有邮件视图中传入 $message变量使其有效：
<body> Here is an image: <img src="<?php echo $message- alt="[ Laravel 5.2 文档 ] 服务 -- 邮件" >embed($pathToFile); ?>"></body>
在邮件视图中嵌入原生数据
如果你想要在邮件消息中嵌入原生数据字符串，可以使用 $message变量上的 embedData方法：
<body> Here is an image from raw data: <img src="<?php echo $message- alt="[ Laravel 5.2 文档 ] 服务 -- 邮件" >embedData($data, $name); ?>"></body>
2.3 邮件队列
邮件消息队列
发送邮件消息可能会大幅度延长应用的响应时间，许多开发者选择将邮件发送放到队列中再后台执行，Laravel中可以使用内置的统一队列API来实现。要将邮件消息放到队列中，使用 Mail门面上的 queue方法：
Mail::queue('emails.welcome', $data, function ($message) { //});该方法自动将邮件任务推送到队列中以便在后台发送。当然，你需要在使用该特性前配置队列。
延迟消息队列
如果你想要延迟已经放到队列中邮件的发送，可以使用 later方法。只需要传递你想要延迟发送的秒数作为第一个参数到该方法即可：
Mail::later(5, 'emails.welcome', $data, function ($message) { //});推入指定队列
如果你想要将邮件消息推送到指定队列，可以使用 queueOn和 laterOn方法：
Mail::queueOn('queue-name', 'emails.welcome', $data, function ($message) { //});Mail::laterOn('queue-name', 5, 'emails.welcome', $data, function ($message) { //});3、邮件&本地开发
开发发送邮件的应用时，你可能不想要真的发送邮件到有效的电子邮件地址，而只是想要做下测试。Laravel提供了几种方式“禁止”邮件的实际发送。
日志驱动
一种解决方案是在本地开发时使用 log邮件驱动。该驱动将所有邮件信息写到日志文件中以备查看，想要了解更多关于每个环境的应用配置信息，查看配置文档。
通用配置
Laravel提供的另一种解决方案是为框架发送的所有邮件设置通用收件人，这样的话，所有应用生成的邮件将会被发送到指定地址，而不是实际发送邮件指定的地址。这可以通过在配置文件 config/mail.php中设置 to选项来实现：
'to' => [ 'address' => 'dev@domain.com', 'name' => 'Dev Example'],
Mailtrap
最后，你可以使用 Mailtrap服务和 smtp驱动发送邮件信息到“虚拟”邮箱，这种方法允许你在Mailtrap的消息查看器中查看最终的邮件。
4、 事件
Laravel 会发送邮件前触发一个事件，记住，这个事件是在邮件被发送时触发，而不是推送到队列时，你可以在 EventServiceProvider中注册事件监听器：
/** * The event listener mappings for the application. * * @var array */protected $listen = [ 'Illuminate\Mail\Events\MessageSending' => [ 'App\Listeners\LogSentMessage', ],];
熱AI工具
Undresser.AI Undress
人工智慧驅動的應用程序，用於創建逼真的裸體照片
AI Clothes Remover
用於從照片中去除衣服的線上人工智慧工具。
Undress AI Tool
免費脫衣圖片
Clothoff.io
AI脫衣器
Video Face Swap
使用我們完全免費的人工智慧換臉工具，輕鬆在任何影片中換臉！
熱門文章
熱工具
記事本++7.3.1
好用且免費的程式碼編輯器
SublimeText3漢化版
中文版，非常好用
禪工作室 13.0.1
強大的PHP整合開發環境
Dreamweaver CS6
視覺化網頁開發工具
SublimeText3 Mac版
神級程式碼編輯軟體(SublimeText3)
PHP和Python：比較兩種流行的編程語言
Apr 14, 2025 am 12:13 AM
PHP和Python各有優勢，選擇依據項目需求。 1.PHP適合web開發，尤其快速開發和維護網站。 2.Python適用於數據科學、機器學習和人工智能，語法簡潔，適合初學者。
說明PHP中的安全密碼散列（例如，password_hash，password_verify）。為什麼不使用MD5或SHA1？
Apr 17, 2025 am 12:06 AM
在PHP中，應使用password_hash和password_verify函數實現安全的密碼哈希處理，不應使用MD5或SHA1。1)password_hash生成包含鹽值的哈希，增強安全性。 2)password_verify驗證密碼，通過比較哈希值確保安全。 3)MD5和SHA1易受攻擊且缺乏鹽值，不適合現代密碼安全。
PHP行動：現實世界中的示例和應用程序
Apr 14, 2025 am 12:19 AM
PHP在電子商務、內容管理系統和API開發中廣泛應用。 1)電子商務：用於購物車功能和支付處理。 2)內容管理系統：用於動態內容生成和用戶管理。 3)API開發：用於RESTfulAPI開發和API安全性。通過性能優化和最佳實踐，PHP應用的效率和可維護性得以提升。
PHP：網絡開發的關鍵語言
Apr 13, 2025 am 12:08 AM
PHP是一種廣泛應用於服務器端的腳本語言，特別適合web開發。 1.PHP可以嵌入HTML，處理HTTP請求和響應，支持多種數據庫。 2.PHP用於生成動態網頁內容，處理表單數據，訪問數據庫等，具有強大的社區支持和開源資源。 3.PHP是解釋型語言，執行過程包括詞法分析、語法分析、編譯和執行。 4.PHP可以與MySQL結合用於用戶註冊系統等高級應用。 5.調試PHP時，可使用error_reporting()和var_dump()等函數。 6.優化PHP代碼可通過緩存機制、優化數據庫查詢和使用內置函數。 7
PHP的持久相關性：它還活著嗎？
Apr 14, 2025 am 12:12 AM
PHP仍然具有活力，其在現代編程領域中依然佔據重要地位。 1)PHP的簡單易學和強大社區支持使其在Web開發中廣泛應用；2)其靈活性和穩定性使其在處理Web表單、數據庫操作和文件處理等方面表現出色；3)PHP不斷進化和優化，適用於初學者和經驗豐富的開發者。
PHP類型提示如何起作用，包括標量類型，返回類型，聯合類型和無效類型？
Apr 17, 2025 am 12:25 AM
PHP類型提示提升代碼質量和可讀性。 1)標量類型提示：自PHP7.0起，允許在函數參數中指定基本數據類型，如int、float等。 2)返回類型提示：確保函數返回值類型的一致性。 3)聯合類型提示：自PHP8.0起，允許在函數參數或返回值中指定多個類型。 4)可空類型提示：允許包含null值，處理可能返回空值的函數。
PHP和Python：代碼示例和比較
Apr 15, 2025 am 12:07 AM
PHP和Python各有優劣，選擇取決於項目需求和個人偏好。 1.PHP適合快速開發和維護大型Web應用。 2.Python在數據科學和機器學習領域佔據主導地位。
PHP與其他語言：比較
Apr 13, 2025 am 12:19 AM
PHP適合web開發，特別是在快速開發和處理動態內容方面表現出色，但不擅長數據科學和企業級應用。與Python相比，PHP在web開發中更具優勢，但在數據科學領域不如Python；與Java相比，PHP在企業級應用中表現較差，但在web開發中更靈活；與JavaScript相比，PHP在後端開發中更簡潔，但在前端開發中不如JavaScript。
