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