講在前面

此教程是筆者通過laravel學院的教程的學習總結，總結了幾個錯誤，以及laravel學院中沒講到的點。laravel學院真心不錯，推薦給大家。

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

實驗使用郵箱的163，QQ郵箱

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

QQ郵箱 > 設置 > 賬戶

需要開啟服務.png

當開啟成功會生成密鑰，這個東西會在配置中用到

生成密鑰.png

當需要記錄發信記錄時，你還需要進行相關配置

image.png

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

開始進行配置

我試驗的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的配置。

1. 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。
3. port用于配置郵箱發送服務端口號，比如一般默認值是25，但如果設置SMTP使用SSL加密，該值為465。
4. from配置項包含address和name，前者表示發送郵箱，后者表示發送郵件使用的用戶名。
5. encryption表示加密類型，可以設置為null表示不使用任何加密，也可以設置為tls或ssl。
6. username表示郵箱賬號，比如yaojinbu@163.com
7. password表示上述郵箱登錄對應登錄密碼。注意QQ郵箱的話應該開啟POP3|SMTP服務時給的密鑰。
8. sendmail是在設置driver為sendmail時使用，用于指定sendmail命令路徑。

開始編寫控制器、路由、模板。

在路由中加入如下規則：

Route::get('mail/send','MailController@send');

生成控制器

php artisan make::controller MailController

在laravel/app/Http/Controllers生成了一個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()的返回值為空，所以可以其他方法進行判斷
        Mail::send('emails.test',['name'=>$name],function($message){
            $to = '282584778@qq.com';
            $message ->to($to)->subject('郵件測試');
        });
        // 返回的一個錯誤數組，利用此可以判斷是否發送成功
        dd(Mail::failures());
  }
}

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

在resources/emails下創建一個模板文件。

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

好，現在在服務器上進行測試了，在地址欄輸入http://wbl.app/mail/send，發送成功。
錯誤解決

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

發送純文本郵件

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

郵件中發送附件

1. 網絡圖片
   當然，可以在模板直接應用靜態文件；但靈活性差，使用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('網絡圖片測試');
        });
        if(count(Mail::failures()) < 1){
            echo '發送郵件成功，請查收！';
        }else{
            echo '發送郵件失敗，請重試！';
        }
 }

現在在服務器上進行測試了，在地址欄輸入http://wbl.app/mail/send

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

# 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 '發送郵件成功，請查收！';
        }else{
            echo '發送郵件失敗，請重試！';
        }
}

郵件附件

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方法上傳附件，該方法第一個參數是附件地址，第二個參數為一些額外參數，這里我們通過as指定附件在郵件中的顯示名稱。

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

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

郵件標題亂碼.png

Paste_Image.png

Paste_Image.png