在 Laravel 5.1 中使用SMTP驱动实现邮件发送（含附件和图片）详细教程

原文地址
1、配置文件
Laravel集成了SwiftMailer库进行邮件发送，邮件配置文件位于config/mail.php：

return [

    'driver' => env('MAIL_DRIVER', 'smtp'),

    'host' => env('MAIL_HOST', 'smtp.mailgun.org'),

    'port' => env('MAIL_PORT', 587),

    'from' => ['address' => null, 'name' => null],

    'encryption' => env('MAIL_ENCRYPTION', 'tls'),

    'username' => env('MAIL_USERNAME'),

    'password' => env('MAIL_PASSWORD'),

    'sendmail' => '/usr/sbin/sendmail -bs',

    'pretend' => false,

]

driver用于配置默认的邮件发送驱动，Laravel支持多种邮件驱动方式，包括smtp、Mailgun、Maildrill、Amazon SES、mail和sendmail，Mailgun和Amazon SES都是收费的，Maildrill目前不支持中国区用户，这三个都是第三方邮件服务。mail驱动使用PHP提供的mail函数发送，sendmail驱动通过Sendmail/Postfix（Linux）提供的命令发送邮件，smtp驱动通过支持ESMTP的SMTP发送邮件。

注：ESMTP即Extended SMTP， 是对标准 SMTP 协议进行的扩展，它与 SMTP 服务的区别仅仅是，使用 SMTP 发信不需要验证用户帐户，而用 ESMTP 发信时，服务器会要求用户提供用户名和密码以便验证身份。
就目前状况来看，使用smtp是最明智的选择，mail不安全，sendmail需要安装配置Sendmail/Postfix，其他要么付费要么不能用（汗！）。下面其它配置的说明都基于driver是smtp。
接下来其他的配置都好理解，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表示上述邮箱登录对应登录密码。

sendmail是在设置driver为sendmail时使用，用于指定sendmail命令路径。

pretend用于配置是否将邮件发送记录到日志中，默认为false则发送邮件不记录日志，如果为true的话只记录日志不发送邮件，这一配置在本地开发中调试时很有用。

根据你的邮箱服务及邮箱账号填写该配置文件，当然很多配置值需要在.env中设置。

2、定义路由
为我们的测试在routes.php定义路由规则：

1

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

3、邮件发送逻辑实现
创建控制器
接下来创建匹配路由的控制器，使用如下命令创建一个干净的MailController：

php artisan make:controller MailController --plain

在app/Http/Controllers目录下生成一个新的控制器MailController：


<?php

namespace App\Http\Controllers;

​

use Illuminate\Http\Request;


use App\Http\Requests;

use App\Http\Controllers\Controller;

​

class MailController extends Controller

{


}

简单邮件发送实现
在该控制器中添加邮件发送动作send()，我们使用Mail门面的send方法发送邮件，我们先发送一个最简单的邮件：

namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
use Mail;
c


lass MailController extends Controller

{

    public function send()

    {

        $name = '学院君';

        $flag = Mail::send('emails.test',['name'=>$name],function($message){

            $to = '1072155122@qq.com';

            $message ->to($to)->subject('测试邮件');

        });

        if($flag){

            echo '发送邮件成功，请查收！';

        }else{
      		echo '发送邮件失败，请重试！';
        }
    }
}

Mail::send需要传递三个参数，第一个是邮件视图，第二个是传入视图的数据，第三个是一个闭包，该闭包中定义了收件人、抄送人（如果有的话）、邮件主题、附件等信息。邮件的主体内容位于局部视图中，下面我们就来定义这个局部视图，在resources/views/emails目录下新建test.blade.php，编辑其内容如下：

1
{{$name}}，这是一封测试邮件
然后我们就可以在浏览器中访问http://laravel.app:8000/mail/send发送邮件，如果页面显示邮件发送成功，那么到收件人邮箱就能收到邮件了：

Laravel简单邮件发送
更简单的纯文本邮件发送
上面的示例仅仅是发送一个字符串，对于纯文本字符串邮件发送，还有更简单的方法：

Mail::raw('这是一封测试邮件', function ($message) {

    $to = '1072155122@qq.com';

    $message ->to($to)->subject('测试邮件');

});

这样的话无需创建视图即可完成邮件发送。

发送带附件的邮件（中文乱码解决）
当然，邮件内容往往不仅仅是纯文本这么简单，有时候我们会在邮件中加上附件，那么这该如何实现呢？

先上代码：

$flag = Mail::send('emails.test',['name'=>$name],function($message){

    $to = '1072155122@qq.com';

    $message->to($to)->subject('测试邮件');

​

    $attachment = storage_path('app/files/test.doc');

    //在邮件中上传附件

    $message->attach($attachment,['as'=>'测试文档.doc']);

});

从代码可知我们使用闭包中$message实例上的attach方法上传附件，该方法第一个参数是附件地址，第二个参数是一些额外参数，这里我们通过as指定附件在邮件中的显示名称。

注：需要注意的是KaTeX parse error: Undefined control sequence: \Mail at position 22: …e实际上是Illuminate\̲M̲a̲i̲l̲\Message的实例，我们可…message上调用Message类的所有方法。
再次访问http://laravel.app:8000/mail/send发送邮件，这样在收件箱中可以看到附件，但附件名称出现中文乱码，解决办法如下：

$message->attach($attachment,['as'=>"=?UTF-8?B?".base64_encode('测试文档')."?=.doc"]);

通过这样处理后，就不会有中文乱码出现了：