講在前面

此教程是筆者通過laravel學(xué)院的教程的學(xué)習(xí)總結(jié)，總結(jié)了幾個(gè)錯(cuò)誤，以及l(fā)aravel學(xué)院中沒講到的點(diǎn)。laravel學(xué)院真心不錯(cuò)，推薦給大家。

laravel自帶SwiftMailer庫，集成了多種郵件API，可以很方便的實(shí)現(xiàn)郵件的發(fā)送。在本教程中使用到的是SMTP（Simple Message Transfer Protocol）簡單郵件傳輸協(xié)議，通常理解為郵件發(fā)送服務(wù)器。

實(shí)驗(yàn)使用郵箱的163，QQ郵箱

需要注意的是：使用QQ郵箱的話，需要開啟POP3和SMTP服務(wù)。開啟方式如下：

QQ郵箱 > 設(shè)置 > 賬戶

需要開啟服務(wù).png

當(dāng)開啟成功會(huì)生成密鑰，這個(gè)東西會(huì)在配置中用到

生成密鑰.png

當(dāng)需要記錄發(fā)信記錄時(shí)，你還需要進(jìn)行相關(guān)配置

image.png

IMAP和POP有什么區(qū)別？
POP允許電子郵件客戶端下載服務(wù)器上的郵件，但是您在電子郵件客戶端的操作（如：移動(dòng)郵件、標(biāo)記已讀等），這是不會(huì)反饋到服務(wù)器上的，比如：您通過電子郵件客戶端收取了QQ郵箱中的3封郵件并移動(dòng)到了其他文件夾，這些移動(dòng)動(dòng)作是不會(huì)反饋到服務(wù)器上的，也就是說，QQ郵箱服務(wù)器上的這些郵件是沒有同時(shí)被移動(dòng)的 。但是IMAP就不同了，電子郵件客戶端的操作都會(huì)反饋到服務(wù)器上，您對郵件進(jìn)行的操作（如：移動(dòng)郵件、標(biāo)記已讀等），服務(wù)器上的郵件也會(huì)做相應(yīng)的動(dòng)作。也就是說，IMAP是“雙向”的。
同時(shí)，IMAP可以只下載郵件的主題，只有當(dāng)您真正需要的時(shí)候，才會(huì)下載郵件的所有內(nèi)容。

開始進(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的配置。

1. driver用于配置默認(rèn)的郵件發(fā)送驅(qū)動(dòng)，Laravel支持多種郵件驅(qū)動(dòng)方式，包括smtp、Mailgun、Maildrill、Amazon SES、mail和sendmail，Mailgun和Amazon SES都是收費(fèi)的Maildrill目前不支持中國區(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郵箱，對應(yīng)值是smtp.163.com，使用QQ郵箱的話，對應(yīng)值是smtp.qq.com。
3. port用于配置郵箱發(fā)送服務(wù)端口號，比如一般默認(rèn)值是25，但如果設(shè)置SMTP使用SSL加密，該值為465。
4. from配置項(xiàng)包含address和name，前者表示發(fā)送郵箱，后者表示發(fā)送郵件使用的用戶名。
5. encryption表示加密類型，可以設(shè)置為null表示不使用任何加密，也可以設(shè)置為tls或ssl。
6. username表示郵箱賬號，比如yaojinbu@163.com
7. password表示上述郵箱登錄對應(yīng)登錄密碼。注意QQ郵箱的話應(yīng)該開啟POP3|SMTP服務(wù)時(shí)給的密鑰。
8. 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
<?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 = '王寶花';
        // Mail::send()的返回值為空，所以可以其他方法進(jìn)行判斷
        Mail::send('emails.test',['name'=>$name],function($message){
            $to = '282584778@qq.com';
            $message ->to($to)->subject('郵件測試');
        });
        // 返回的一個(gè)錯(cuò)誤數(shù)組，利用此可以判斷是否發(fā)送成功
        dd(Mail::failures());
  }
}

Mail::send();需要傳三個(gè)參數(shù)，第一個(gè)為引用的模板，第二個(gè)為給模板傳遞的變量，第三個(gè)為一個(gè)閉包，參數(shù)綁定Mail類的一個(gè)實(shí)例。
Mailer::send文檔
Mailer:: failures文檔

在resources/emails下創(chuàng)建一個(gè)模板文件。

# test.blade.php
{{$name}}你好，這是一封測試文件。

好，現(xiàn)在在服務(wù)器上進(jìn)行測試了，在地址欄輸入http://wbl.app/mail/send，發(fā)送成功。
錯(cuò)誤解決

1. 頁面無異常輸出，顯示500的錯(cuò)誤，是服務(wù)器的問題，如果是Nginx的則檢查/var/log/nginx/errors.log；如果是apache則檢茶/usr/local/apache2/logs/error.log，然后根據(jù)提示解決就行，permission的問題話就應(yīng)該是storage的權(quán)限問題。
2. 頁面有報(bào)錯(cuò)，根據(jù)報(bào)錯(cuò)解決即可，一般都是語法格式或者是沒有使用正確命名空間。

發(fā)送純文本郵件

Mail::raw('你好，我是PHP程序！', function ($message) {
    $to = '282584778@qq.com';
    $message ->to($to)->subject('純文本信息郵件測試');
});

郵件中發(fā)送附件

1. 網(wǎng)絡(luò)圖片
   當(dāng)然，可以在模板直接應(yīng)用靜態(tài)文件；但靈活性差，使用embed方法更靈活。

# test.blade.php
{{$name}}你好，這是一封測試文件。 
<br>
<img src='{{$message->embed($image)}}'> 

 public function send()
  {
        $name = '王寶花';
        $image = 'http://d.hiphotos.baidu.com/zhidao/pic/item/1ad5ad6eddc451da4ab93e2bb0fd5266d11632a6.jpg';
        Mail::send('emails.test',['name'=>$name,'imgPath'=>$image],function($message){
            $to = '282584778@qq.com';
            $message ->to($to)->subject('網(wǎng)絡(luò)圖片測試');
        });
        if(count(Mail::failures()) < 1){
            echo '發(fā)送郵件成功，請查收！';
        }else{
            echo '發(fā)送郵件失敗，請重試！';
        }
 }

現(xiàn)在在服務(wù)器上進(jìn)行測試了，在地址欄輸入http://wbl.app/mail/send

2. 本地圖片
   本地圖片引用需要使用到Storage類，模板方法略有不同，在Storage/images文件夾中有一張圖片。
   embedData()兩個(gè)參數(shù)，第一個(gè)為圖片，第二個(gè)為自定義圖片名稱。

# test.blade.php
{{$name}}，這是一封測試郵件
<br>
<img src="{{$message->embedData($image,'我的自拍照.jpg')}}">

# MailController.php
 public function send(){
      $image = Storage::get('images/obama.jpg');
      Mail::send('emails.test',['image'=>$image],function($message){
      $to = '282584778@qq.com';
      $message->to($to)->subject('[本地圖片測試]');
      });
      if(count(Mail::failures()) < 1){
            echo '發(fā)送郵件成功，請查收！';
        }else{
            echo '發(fā)送郵件失敗，請重試！';
        }
}

郵件附件

public function sendFile(){
    $name = '王寶花';
    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指定附件在郵件中的顯示名稱。

測試如果顯示文件名亂碼的話，就這樣寫

$message->attach($attachment,['as'=>"=?UTF-8?B?".base64_encode('中文文檔')."?=.txt"]);

郵件標(biāo)題亂碼.png

Paste_Image.png

Paste_Image.png