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

0、

步骤一：使我们的QQ邮箱能够发送邮件

这里怎么说能够发送邮件呢？其实我们的邮箱都是可以发送邮件的，但是要实现在我们的网站中发送邮件，那就要设置一下我们的QQ邮箱了，因为此时我们的网站现在是作为一个第三方客户端存在的。



由于待会我们用到的是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（Linu
18ded
x）提供的命令发送邮件，

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

中设置。

例如我的.env中的配置如下:

MAIL_DRIVER=smtp
MAIL_HOST=smtp.qq.com
MAIL_PORT=465
MAIL_USERNAME=312479274@qq.com
MAIL_PASSWORD=moxcryepjdktbjhg
MAIL_ENCRYPTION=ssl

2、定义路由

为我们的测试在

routes.php

定义路由规则：

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

方法发送邮件，我们先发送一个最简单的邮件：

<?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

发送邮件，如果页面显示邮件发送成功，那么到收件人邮箱就能收到邮件了：



我的代码示例:其中 在闭包中传参数用 use 例如:

function($message) use($tomail)

public function send(Request $request)
{
$info="";
if($request->username=="")
return -1;
$tomail=$request->username;
for($i=0;$i<4;$i++)
{
$code=random_int(1000,9999);
}
$name = 'xxx';
$info['name']=$name;
$info['code']=$code;
$flag = Mail::send('emails.emails',['info'=>$info],function($message) use($tomail){
$message ->to($tomail)->subject("验证码");
});
if(!$flag){
Session::put('code', $code);
echo '发送邮件成功，请查收！';
}else{
echo '发送邮件失败，请重试！'.$flag;
}
}

更简单的纯文本邮件发送

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

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发送邮件，邮件发送成功去收件箱查看邮件内容：



同样可以成功插入图片。