服務(wù) ―― 郵件
服務(wù) —— 郵件
1、簡(jiǎn)介
Laravel基于目前流行的SwiftMailer庫(kù)提供了一套干凈清爽的郵件、PHP的mail函數(shù)，以及sendmail提供了驅(qū)動(dòng)，從而允許你快速通過本地或云服務(wù)發(fā)送郵件。
1.1 郵件驅(qū)動(dòng)預(yù)備知識(shí)
基于驅(qū)動(dòng)的API如Mail?HTTP庫(kù)。你可以通過添加如下行到composer.json文件來安裝Guzzle到項(xiàng)目：
"guzzlehttp/guzzle": "~5.3|~6.0"1.1.1 Mailgun驅(qū)動(dòng)
要使用Mailgun驅(qū)動(dòng)，首先安裝Guzzle，然后在配置文件config/mail.php中設(shè)置driver選項(xiàng)為mailgun。接下來，驗(yàn)證配置文件config/services.php包含如下選項(xiàng)：
'mailgun' => [
'domain' => 'your-mailgun-domain',
'secret' => 'your-mailgun-key',],1.1.2 Mandrill驅(qū)動(dòng)
要使用Mandrill驅(qū)動(dòng)，首先安裝Guzzle，然后在配置文件config/mail.php中設(shè)置driver選項(xiàng)值為mandrill。接下來，驗(yàn)證配置文件config/services.php包含如下選項(xiàng)：
'mandrill' => [
'secret' => 'your-mandrill-key',],1.1.3 SES驅(qū)動(dòng)
要使用Amazon SES驅(qū)動(dòng)，安裝Amazon AWS的PHP SDK，你可以通過添加如下行到composer.json文件的require部分來安裝該庫(kù)：
"aws/aws-sdk-php": "~3.0"接下來，設(shè)置配置文件config/mail.php中的driver選項(xiàng)為ses。然后，驗(yàn)證配置文件config/services.php包含如下選項(xiàng)：
'ses' => [
'key' => 'your-ses-key',
'secret' => 'your-ses-secret',
'region' => 'ses-region', // e.g. us-east-1
],2、發(fā)送郵件
Laravel允許你在視圖中存儲(chǔ)郵件信息，例如，要組織你的電子郵件，可以在resources/views目錄下創(chuàng)建emails目錄。
要發(fā)送一條信息，使用Mail門面上的send方法。send方法接收三個(gè)參數(shù)。第一個(gè)參數(shù)是包含郵件信息的視圖名稱；第二個(gè)參數(shù)是你想要傳遞到該視圖的數(shù)組數(shù)據(jù)；第三個(gè)參數(shù)是接收消息實(shí)例的閉包回調(diào)——允許你自定義收件人、主題以及郵件其他方面的信息：
<?php
namespace App\Http\Controllers;
use Mail;
use App\User;
use Illuminate\Http\Request;
use App\Http\Controllers\Controller;
class UserController extends Controller{
/**
* 發(fā)送郵件給用戶
*
* @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->to($user->email, $user->name)->subject('Your Reminder!');
});
}
}由于我們?cè)谏侠袀鬟f一個(gè)包含user鍵的數(shù)組，我們可以在郵件中使用如下方式顯示用戶名：
<?php echo $user->name; ?>注意：
$message變量總是被傳遞到郵件視圖，并允許嵌入附件，因此，你應(yīng)該在視圖負(fù)載中避免傳入消息變量。
構(gòu)造消息
正如前面所討論的，傳遞給send方法的第三個(gè)參數(shù)是一個(gè)允許你指定郵件消息本身多個(gè)選項(xiàng)的閉包。使用這個(gè)閉包可以指定消息的其他屬性，例如抄送、群發(fā)，等等：
Mail::send('emails.welcome', $data, function ($message) {
$message->from('us@example.com', 'Laravel');
$message->to('foo@example.com')->cc('bar@example.com');
});下面試$message消息構(gòu)建器實(shí)例上的可用方法：
$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消息實(shí)例...
$message->getSwiftMessage();注意：傳遞給
Mail::send閉包的消息實(shí)例繼承自SwiftMailer消息類，該實(shí)例允許你調(diào)用該類上的任何方法來構(gòu)建自己的電子郵件消息。
純文本郵件
默認(rèn)情況下，傳遞給send方法的視圖假定包含HTML，然而，通過傳遞數(shù)組作為第一個(gè)參數(shù)到send方法，你可以指定發(fā)送除HTML視圖之外的純文本視圖：
Mail::send(['html.view', 'text.view'], $data, $callback);或者，如果你只需要發(fā)送純文本郵件，可以指定在數(shù)組中使用text鍵：
Mail::send(['text' => 'view'], $data, $callback);原生字符串郵件
如果你想要直接發(fā)送原生字符串郵件你可以使用raw方法：
Mail::raw('Text to e-mail', function ($message) {
//
});2.1 附件
要添加附件到郵件，使用傳遞給閉包的$message對(duì)象上的attach方法。該方法接收文件的絕對(duì)路徑作為第一個(gè)參數(shù)：
Mail::send('emails.welcome', $data, function ($message) {
//
$message->attach($pathToFile);
});當(dāng)添加文件到消息時(shí)，你還可以通過傳遞數(shù)組作為第二個(gè)參數(shù)到attach方法來指定文件顯示名和MIME類型：
$message->attach($pathToFile, ['as' => $display, 'mime' => $mime]);2.2 內(nèi)聯(lián)附件
2.2.1 在郵件視圖中嵌入一張圖片
嵌套內(nèi)聯(lián)圖片到郵件中通常是很笨重的，然而，Laravel提供了一個(gè)便捷的方式附加圖片到郵件并獲取相應(yīng)的CID，要嵌入內(nèi)聯(lián)圖片，在郵件視圖中使用$message變量上的embed方法。記住，Laravel自動(dòng)在所有郵件視圖中傳入$message變量使其有效：
<body>
Here is an image:
<img src="<?php echo $message->embed($pathToFile); ?>">
</body>2.2.2 在郵件視圖中嵌入原生數(shù)據(jù)
如果你想要在郵件消息中嵌入原生數(shù)據(jù)字符串，可以使用$message變量上的embedData方法：
<body>
Here is an image from raw data:
<img src="<?php echo $message->embedData($data, $name); ?>">
</body>2.3 郵件隊(duì)列
2.3.1 郵件消息隊(duì)列
發(fā)送郵件消息可能會(huì)大幅度延長(zhǎng)應(yīng)用的響應(yīng)時(shí)間，許多開發(fā)者選擇將郵件發(fā)送放到隊(duì)列中再后臺(tái)執(zhí)行，Laravel中可以使用內(nèi)置的統(tǒng)一隊(duì)列API來實(shí)現(xiàn)。要將郵件消息放到隊(duì)列中，使用Mail門面上的queue方法：
Mail::queue('emails.welcome', $data, function ($message) {
//
});該方法自動(dòng)將郵件任務(wù)推送到隊(duì)列中以便在后臺(tái)發(fā)送。當(dāng)然，你需要在使用該特性前配置隊(duì)列。
2.3.2 延遲消息隊(duì)列
如果你想要延遲已經(jīng)放到隊(duì)列中郵件的發(fā)送，可以使用later方法。只需要傳遞你想要延遲發(fā)送的秒數(shù)作為第一個(gè)參數(shù)到該方法即可：
Mail::later(5, 'emails.welcome', $data, function ($message) {
//
});2.3.3 推入指定隊(duì)列
如果你想要將郵件消息推送到指定隊(duì)列，可以使用queueOn和laterOn方法：
Mail::queueOn('queue-name', 'emails.welcome', $data, function ($message) {
//
});
Mail::laterOn('queue-name', 5, 'emails.welcome', $data, function ($message) {
//
});3、郵件&本地開發(fā)
開發(fā)發(fā)送郵件的應(yīng)用時(shí)，你可能不想要真的發(fā)送郵件到有效的電子郵件地址，而只是想要做下測(cè)試。Laravel提供了幾種方式“禁止”郵件的實(shí)際發(fā)送。
3.1?日志驅(qū)動(dòng)
一種解決方案是在本地開發(fā)時(shí)使用log郵件驅(qū)動(dòng)。該驅(qū)動(dòng)將所有郵件信息寫到日志文件中以備查看，想要了解更多關(guān)于每個(gè)環(huán)境的應(yīng)用配置信息，查看配置文檔。
3.2 通用配置
Laravel提供的另一種解決方案是為框架發(fā)送的所有郵件設(shè)置通用收件人，這樣的話，所有應(yīng)用生成的郵件將會(huì)被發(fā)送到指定地址，而不是實(shí)際發(fā)送郵件指定的地址。這可以通過在配置文件config/mail.php中設(shè)置to選項(xiàng)來實(shí)現(xiàn)：
'to' => [
'address' => 'dev@domain.com',
'name' => 'Dev Example'
],3.3?Mailtrap
最后，你可以使用Mailtrap服務(wù)和smtp驅(qū)動(dòng)發(fā)送郵件信息到“虛擬”郵箱，這種方法允許你在Mailtrap的消息查看器中查看最終的郵件。
更多建議：