轉(zhuǎn)自王寶花http://www.lxweimin.com/p/8ccb2820df23
此教程是筆者通過laravel學(xué)院的教程的學(xué)習(xí)總結(jié),總結(jié)了幾個(gè)錯(cuò)誤,以及l(fā)aravel學(xué)院中沒講到的點(diǎn)。laravel學(xué)院真心不錯(cuò),推薦給大家。
laravel自帶SwiftMailer庫(kù),集成了多種郵件API,可以很方便的實(shí)現(xiàn)郵件的發(fā)送。在本教程中使用到的是SMTP(Simple Message Transfer Protocol)簡(jiǎn)單郵件傳輸協(xié)議,通常理解為郵件發(fā)送服務(wù)器。
實(shí)驗(yàn)使用郵箱的163,QQ郵箱
需要注意的是:使用QQ郵箱的話,需要開啟POP3和SMTP服務(wù)。開啟方式如下:
QQ郵箱 > 設(shè)置 > 賬戶
當(dāng)開啟成功會(huì)生成密鑰,這個(gè)東西會(huì)在配置中用到
開始進(jìn)行配置
我試驗(yàn)的laravel項(xiàng)目名稱為《laravel》
# 編輯郵件配置文件
$ vim laravel/config/mail.php
# mail.php
return [
'driver' => env('MAIL_DRIVER', 'smtp'),
'host' => env('MAIL_HOST', 'smtp.163.com'),
'port' => env('MAIL_PORT', 25),
'from' => ['address' => '18010029423@163.com','name' => '發(fā)件人'],
'encryption' => env('MAIL_ENCRYPTION', 'tls'),
'username' => env('MAIL_USERNAME'),
'password' => env('MAIL_PASSWORD'),
'sendmail' => '/usr/sbin/sendmail -bs',
]
# 編輯環(huán)境配置文件
vim laravel/.env
#.env
MAIL_DRIVER=
MAIL_HOST=
MAIL_PORT=
MAIL_USERNAME=yourname@163.com
MAIL_PASSWORD=password
MAIL_ENCRYPTION=
.env文件需要配置username和password其余為空,則會(huì)使用mail.php的配置。
-
driver
用于配置默認(rèn)的郵件發(fā)送驅(qū)動(dòng),Laravel支持多種郵件驅(qū)動(dòng)方式,包括smtp、Mailgun、Maildrill、Amazon SES、mail和sendmail,Mailgun和Amazon SES都是收費(fèi)的Maildrill目前不支持中國(guó)區(qū)用戶,這三個(gè)都是第三方郵件服務(wù)。mail驅(qū)動(dòng)使用PHP提供的mail函數(shù)發(fā)送,sendmail驅(qū)動(dòng)通過Sendmail/Postfix(Linux)提供的命令發(fā)送郵件,smtp驅(qū)動(dòng)通過支持ESMTP的SMTP發(fā)送郵件。
就目前狀況來看,使用smtp是最明智的選擇,mail不安全,sendmail需要安裝配置Sendmail/Postfix,其他要么付費(fèi)要么不能用。
2.host
是郵箱所在主機(jī),比如我們使用163郵箱,對(duì)應(yīng)值是smtp.163.com
,使用QQ郵箱的話,對(duì)應(yīng)值是smtp.qq.com
。 -
port
用于配置郵箱發(fā)送服務(wù)端口號(hào),比如一般默認(rèn)值是25,但如果設(shè)置SMTP使用SSL加密,該值為465。 -
from
配置項(xiàng)包含address和name,前者表示發(fā)送郵箱,后者表示發(fā)送郵件使用的用戶名。 -
encryption
表示加密類型,可以設(shè)置為null表示不使用任何加密,也可以設(shè)置為tls或ssl。 -
username
表示郵箱賬號(hào),比如yaojinbu@163.com -
password
表示上述郵箱登錄對(duì)應(yīng)登錄密碼。注意QQ郵箱的話應(yīng)該開啟POP3|SMTP服務(wù)時(shí)給的密鑰。 -
sendmail
是在設(shè)置driver為sendmail時(shí)使用,用于指定sendmail命令路徑。
開始編寫控制器、路由、模板。
在路由中加入如下規(guī)則:
Route::get('mail/send','MailController@send');
生成控制器
php artisan make::controller MailController
在laravel/app/Http/Controllers生成了一個(gè)MailController控制器,如下所示:
# MailController.php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
class MailController extends Controller{
//
}
編輯控制器,加入以下的邏輯處理
use Mail;
class MailController{
public function send(){
$name = '王寶花';
$flag = Mail::send('emails.test',['name'=>$name],function($message){
$to = '282584778@qq.com';
$message ->to($to)->subject('郵件測(cè)試');
});
if($flag){
echo'發(fā)送郵件成功,請(qǐng)查收!';
}else{
echo'發(fā)送郵件失敗,請(qǐng)重試!';
}
}
}
Mail::send();需要傳三個(gè)參數(shù),第一個(gè)為引用的模板,第二個(gè)為給模板傳遞的變量,第三個(gè)為一個(gè)閉包,參數(shù)綁定Mail類的一個(gè)實(shí)例。
在resources/emails下創(chuàng)建一個(gè)模板文件。
# test.blade.php
{{$name}}你好,這是一封測(cè)試文件。
好,現(xiàn)在在服務(wù)器上進(jìn)行測(cè)試了,在地址欄輸入http://wbl.app/mail/send
,發(fā)送成功。
錯(cuò)誤解決
- 頁面無異常輸出,顯示500的錯(cuò)誤,是服務(wù)器的問題,如果是Nginx的則檢查
/var/log/nginx/errors.log;
如果是apache則檢查/usr/local/apache2/logs/error.log
,然后根據(jù)提示解決就行,permission的問題話就應(yīng)該是storage的權(quán)限問題。 - 頁面有報(bào)錯(cuò),根據(jù)報(bào)錯(cuò)解決即可,一般都是語法格式或者是沒有使用正確命名空間。
發(fā)送純文本郵件
Mail::raw('你好,我是PHP程序!', function($message){
$to = '282584778@qq.com';
$message ->to($to)->subject('純文本信息郵件測(cè)試');
});
郵件中發(fā)送附件
- 網(wǎng)絡(luò)圖片
當(dāng)然,可以在模板直接應(yīng)用靜態(tài)文件;但靈活性差,使用embed方法更靈活。
# test.blade.php
{{$name}}你好,這是一封測(cè)試文件。
<br>
<img src='{{$message->embed($image)}}'
>
publicfunctionsend(){
$name = '王寶花';
$image = 'http://d.hiphotos.baidu.com/zhidao/pic/item/1ad5ad6eddc451da4ab93e2bb0fd5266d11632a6.jpg';
$flag = Mail::send('emails.test',['name'=>$name,'imgPath'=>$image],function($message){
$to = '282584778@qq.com';
$message ->to($to)->subject('網(wǎng)絡(luò)圖片測(cè)試');
});
if($flag){
echo'發(fā)送郵件成功,請(qǐng)查收!';
}else{
echo'發(fā)送郵件失敗,請(qǐng)重試!';
}}
現(xiàn)在在服務(wù)器上進(jìn)行測(cè)試了,在地址欄輸入http://wbl.app/mail/send
- 本地圖片
本地圖片引用需要使用到Storage類,模板方法略有不同,在Storage/images文件夾中有一張圖片。
embedData()兩個(gè)參數(shù),第一個(gè)為圖片,第二個(gè)為自定義圖片名稱。
# test.blade.php
{{$name}},這是一封測(cè)試郵件
<br>
<img src="{{$message->embedData($image,'我的自拍照.jpg')}}">
# MailController.php
public functionsend(){
$image = Storage::get('images/obama.jpg');
$flag = Mail::send('emails.test',['image'=>$image],function($message){
$to = '282584778@qq.com';
$message->to($to)->subject('[本地圖片測(cè)試]');
});
if($flag){
echo'發(fā)送郵件成功,請(qǐng)查收!';
}else{
echo'發(fā)送郵件失敗,請(qǐng)重試!';
}
}
郵件附件
public functionsendFile(){
$name = '王寶花';
$flag = Mail::send('emails.test',['name'=>$name],function($message){
$to = '282584778@qq.com';
$message->to($to)->subject('郵件主題');
$attachment = storage_path('app/files/test.txt');
// 在郵件中上傳附件
$message->attach($attachment,['as'=>'中文文檔.txt']);
});
}
$message的attach方法上傳附件,該方法第一個(gè)參數(shù)是附件地址,第二個(gè)參數(shù)為一些額外參數(shù),這里我們通過as指定附件在郵件中的顯示名稱。
測(cè)試如果顯示文件名亂碼的話,就這樣寫
$message->attach($attachment,['as'=>"=?UTF-8?B?".base64_encode('中文文檔')."?=.txt"]);