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

一、 配置 文件

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 中设置。

二、定义路由

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

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

三、邮件发送逻辑实现

建立控制器

接下来建立匹配路由的控制器，使用以下命令建立一个干净的 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 方法发送邮件，咱们先发送一个最简单的邮件：

<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
use App\Http\Requests;
use App\Http\Controllers\Controller;
use Mail;
class 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 ，编辑其内容以下：

{{$name}}，这是一封测试邮件

而后咱们就能够在浏览器中访问 http://laravel.app:8000/mail/send 发送邮件，若是页面显示邮件发送成功，那么到收件人邮箱就能收到邮件了：

更简单的纯文本邮件发送

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

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 指定附件在邮件中的显示名称。

注：须要注意的是 $message 其实是 Illuminate\Mail\Message 的实例，咱们能够在 $message 上调用 Message 类的全部方法。

再次访问 http://laravel.app:8000/mail/send 发送邮件，这样在收件箱中能够看到附件，但附件名称出现中文乱码，解决办法以下：

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

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

发送带图片的邮件

embed

除了附件以外，有时候为了让邮件内容更丰富，还会在邮件内容中插入图片，咱们当然能够在邮件视图中硬编码写入图片路径，可是这显然很笨重，灵活性不好，Laravel为咱们提供了便捷方法——在视图中使用 $message 上的 embed 方法：

{{$name}}，这是一封测试邮件
<br>
<img src="{{$message->embed($imgPath)}}">

这里的 $message 就是上述邮件发送闭包中的 $message ，Laravel内部自动将该变量传递到邮件视图。固然咱们还须要在控制器动做中传入 $imgPath 变量：

$name = '学院君';
$imgPath = 'http://laravelacademy.org/wp-statics/images/carousel/LaravelAcademy.jpg';
$flag = Mail::send('emails.test',['name'=>$name,'imgPath'=>$imgPath],function($message){
  $to = '1072155122@qq.com';
  $message->to($to)->subject('测试邮件');
  $attachment = storage_path('app/files/test.doc');
  //在邮件中上传附件
  $message->attach($attachment,['as'=>"=?UTF-8?B?".base64_encode('测试文档')."?=.doc"]);
});

在浏览器中访问 http://laravel.app:8000/mail/send 发送邮件，邮件发送成功后去收件箱查看：

因而可知，图片已经插入到邮件内容中。

embedData

此外还支持发送原生的图片数据到邮件中，即将本地图片读取到内存而后渲染到邮件视图，这能够经过 $message 上的 embedData 实现。

首先咱们修改控制器动做以下：

$name = '学院君';
//$imgPath = 'http://laravelacademy.org/wp-statics/images/carousel/LaravelAcademy.jpg';
$image = Storage::get('images/test.jpg');
$flag = Mail::send('emails.test',['name'=>$name,'image'=>$image],function($message){
  $to = '1072155122@qq.com';
  $message->to($to)->subject('测试邮件');
  $attachment = storage_path('app/files/test.doc');
  //在邮件中上传附件
  $message->attach($attachment,['as'=>"=?UTF-8?B?".base64_encode('测试文档')."?=.doc"]);
});

记得在 MailController 顶部加上 use Storage ，而后修改邮件视图 test.blade.php 以下：

{{$name}}，这是一封测试邮件
<br>
<img src="{{$message->embedData($image,'LaravelAcademy.jpg')}}">

最后去浏览器中访问http://laravel.app:8000/mail/send发送邮件，邮件发送成功去收件箱查看邮件内容：

一样能够成功插入图片。

=================================

http://www.tuicool.com/articles/uE7Z3aF