Laravel 基于熱門的 SwiftMailer 函數(shù)庫之上,提供了一個簡潔的 API。郵件配置文件為 config/mail.php
,包含若干選項,讓您可以更改 SMTP 主機、連接端口、憑證,也可以讓您對函數(shù)庫發(fā)送出去的所有消息配置全局的 from
地址。您可使用任何您想要的 SMTP 服務(wù)器。如果想使用 PHP mail
函數(shù)來發(fā)送郵件,您可以將配置文件中的 driver
更改為 mail
。您也可以使用 sendmail
驅(qū)動器。
Laravel 也包含了 Mailgun 及 Mandrill HTTP API 的驅(qū)動。這些 API 通常比 SMTP 服務(wù)器更簡單快速。這兩套驅(qū)動都需要在應(yīng)用程序中安裝 Guzzle 5 HTTP 函數(shù)庫。您可在 composer.josn
中加入下列代碼, 以便在應(yīng)用中加入 Guzzle 5:
"guzzlehttp/guzzle": "~5.0"
要使用 Mailgun 驅(qū)動,請將 config/mail.php
配置文件中的 driver
選項配置為 mailgun
。接下來,若 config/service.php
配置文件還不存在于您的應(yīng)用中,請建立此文件,并確認(rèn)其包含下列選項:
'mailgun' => [ 'domain' => 'your-mailgun-domain', 'secret' => 'your-mailgun-key',],
要使用 Mandrill 驅(qū)動,將 config/mail.php
配置文件中的 driver
選項配置為 mandrill
。接下來,若 config/service.php
配置文件還不存在于您的應(yīng)用中,請建立此文件,并確認(rèn)其包含下列選項:
'mandrill' => [ 'secret' => 'your-mandrill-key',],
若您的 config/mail.php
配置文件中的 driver
選項配置為 log
,所有的電子郵件都會被寫入日志文件,而不會真正寄給任何收件者。這主要用于快速的本地端除錯及內(nèi)容驗證。
您可使用 Mail::send
方法來發(fā)送電子郵件消息:
Mail::send('emails.welcome', ['key' => 'value'], function($message){ $message->to('foo@example.com', 'John Smith')->subject('Welcome!');});
傳入 send
方法的第一個參數(shù)為郵件視圖的名稱。第二個是傳遞給該視圖的數(shù)據(jù),通常是一個關(guān)聯(lián)式數(shù)組,讓視圖可通過 $key
來取得數(shù)據(jù)對象。第三個參數(shù)是一個閉包,可以對 message 進行各種配置。
注意:
$message
變量總是會被傳入郵件視圖中,并且允許內(nèi)嵌附件。因此最好避免在您的視圖本體中傳入message
變量。
除了 HTML 視圖外,您也可以指定使用純文本視圖:
Mail::send(['html.view', 'text.view'], $data, $callback);
或者,您可使用 html
或 text
作為鍵值來指定單一類型的視圖:
Mail::send(['text' => 'view'], $data, $callback);
您也可以在郵件消息中指定其他選項,例如副本收件者或附件:
Mail::send('emails.welcome', $data, function($message){ $message->from('us@example.com', 'Laravel'); $message->to('foo@example.com')->cc('bar@example.com'); $message->attach($pathToFile);});
要附加文件至 message 時,可以指定 MIME 的類型、顯示名稱:
$message->attach($pathToFile, ['as' => $display], 'mime' => $mime));
若您只需發(fā)送一個簡單的字串而非完整的視圖,可使用 raw
方法:
Mail::raw('Text to e-mail', function($message){ $message->from('us@example.com', 'Laravel'); $message->to('foo@example.com')->cc('bar@example.com');});
注意: 傳遞至
Mail::send
閉包的 message 實例是繼承了 SwiftMailer 的 message 類,你可以調(diào)用該類的任何方法來建立電子郵件消息。
在電子郵件中嵌入內(nèi)部圖像通常很麻煩;然而 Laravel 提供一個便利的方法讓您對電子郵件附加圖像,并取得相應(yīng)的 CID。
<body> 這是一張圖像: <img src="<?php echo $message->embed($pathToFile); ?>"></body>
<body> 這是一張從原始數(shù)據(jù)來的圖像: <img src="<?php echo $message->embedData($data, $name); ?>"></body>
請注意 Mail
類總是會將 $message
變量傳遞給電子郵件視圖。
發(fā)送電子郵件消息會大幅延長應(yīng)用程序的響應(yīng)時間,因此許多開發(fā)者選擇將郵件消息加入隊列并于后臺發(fā)送。 Laravel 使用內(nèi)置 統(tǒng)一的 queue API ,讓您輕松地完成此工作。要將郵件消息加入隊列,只要使用 Mail
類的 queue
方法:
Mail::queue('emails.welcome', $data, function($message){ $message->to('foo@example.com', 'John Smith')->subject('Welcome!');});
您也可以使用 later
方法來指定您希望延遲發(fā)送郵件消息的秒數(shù):
Mail::later(5, 'emails.welcome', $data, function($message){ $message->to('foo@example.com', 'John Smith')->subject('Welcome!');});
若您想要指定特定的隊列或「管道」來加入消息,您可使用 queueOn
以及 laterOn
方法:
Mail::queueOn('queue-name', 'emails.welcome', $data, function($message){ $message->to('foo@example.com', 'John Smith')->subject('Welcome!');});
當(dāng)開發(fā)發(fā)送電子郵件的應(yīng)用程序時,我們通常希望不要真的從本地端或開發(fā)環(huán)境發(fā)送郵件。您可以使用 Mail::pretend
方法或?qū)?config/mail.php
配置文件中的 pretend
選項配置為 true
。在 pretend
模式下,消息會改而寫入應(yīng)用程序的日志文件,而不會真的發(fā)送給收件者。
若您想要實際閱覽測試的郵件,可考慮使用如 MailTrap 的服務(wù)。
更多建議: