1、 配置 文件
Laravel集成了SwiftMailer库进行邮件发送，邮件配置文件位于 config/mail.php：
|
1 2 |
<span class="keyword" style="font-weight:bold;">return</span> [ <span class="indent"> </span><span class="string" style="color:#DD1144;">'driver'</span> => env(<span class="string" style="color:#DD1144;">'MAIL_DRIVER'</span>, <span class="string" style="color:#DD1144;">'smtp'</span>), <span class="indent"> </span><span class="string" style="color:#DD1144;">'host'</span> => env(<span class="string" style="color:#DD1144;">'MAIL_HOST'</span>, <span class="string" style="color:#DD1144;">'smtp.mailgun.org'</span>), <span class="indent"> </span><span class="string" style="color:#DD1144;">'port'</span> => env(<span class="string" style="color:#DD1144;">'MAIL_PORT'</span>, <span class="number" style="color:#009999;">587</span>), <span class="indent"> </span><span class="string" style="color:#DD1144;">'from'</span> => [<span class="string" style="color:#DD1144;">'address'</span> => <span class="keyword" style="font-weight:bold;">null</span>, <span class="string" style="color:#DD1144;">'name'</span> => <span class="keyword" style="font-weight:bold;">null</span>], <span class="indent"> </span><span class="string" style="color:#DD1144;">'encryption'</span> => env(<span class="string" style="color:#DD1144;">'MAIL_ENCRYPTION'</span>, <span class="string" style="color:#DD1144;">'tls'</span>), <span class="indent"> </span><span class="string" style="color:#DD1144;">'username'</span> => env(<span class="string" style="color:#DD1144;">'MAIL_USERNAME'</span>), <span class="indent"> </span><span class="string" style="color:#DD1144;">'password'</span> => env(<span class="string" style="color:#DD1144;">'MAIL_PASSWORD'</span>), <span class="indent"> </span><span class="string" style="color:#DD1144;">'sendmail'</span> => <span class="string" style="color:#DD1144;">'/usr/sbin/sendmail -bs'</span>, <span class="indent"> </span><span class="string" style="color:#DD1144;">'pretend'</span> => <span class="keyword" style="font-weight:bold;">false</span>, ] |
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::<span class="keyword" style="font-weight:bold;">get</span>(<span class="string" style="color:#DD1144;">'mail/send'</span>,<span class="string" style="color:#DD1144;">'MailController@send'</span>); |
3、邮件发送逻辑实现
创建控制器
接下来创建匹配路由的控制器，使用如下命令创建一个干净的 MailController ：
|
1 |
<span class="tag" style="color:#000080;">php</span> <span class="tag" style="color:#000080;">artisan</span> <span class="tag" style="color:#000080;">make</span><span class="pseudo">:controller</span> <span class="tag" style="color:#000080;">MailController</span> --<span class="tag" style="color:#000080;">plain</span> |
在 app/Http/Controllers 目录下生成一个新的控制器 MailController ：
|
1 |
<span class="preprocessor" style="color:#999999;font-weight:bold;"><?php</span> <span class="keyword" style="font-weight:bold;">namespace</span> App\Http\Controllers; <span class="keyword" style="font-weight:bold;">use</span> Illuminate\Http\Request; <span class="keyword" style="font-weight:bold;">use</span> App\Http\Requests; <span class="keyword" style="font-weight:bold;">use</span> App\Http\Controllers\Controller; <span class="class" style="color:#445588;font-weight:bold;"><span class="keyword" style="color:#333333;">class</span> <span class="title">MailController</span> <span class="keyword" style="color:#333333;">extends</span> <span class="title">Controller</span> {</span> <span class="comment" style="color:#999988;font-style:italic;">//</span> } |
简单邮件发送实现
在该控制器中添加邮件发送动作 send() ，我们使用 Mail 门面的 send 方法发送邮件，我们先发送一个最简单的邮件：
|
1 2 |
<span class="preprocessor" style="color:#999999;font-weight:bold;"><?php</span> <span class="keyword" style="font-weight:bold;">namespace</span> App\Http\Controllers; <span class="keyword" style="font-weight:bold;">use</span> Illuminate\Http\Request; <span class="keyword" style="font-weight:bold;">use</span> App\Http\Requests; <span class="keyword" style="font-weight:bold;">use</span> App\Http\Controllers\Controller; <span class="keyword" style="font-weight:bold;">use</span> Mail; <span class="class" style="color:#445588;font-weight:bold;"><span class="keyword" style="color:#333333;">class</span> <span class="title">MailController</span> <span class="keyword" style="color:#333333;">extends</span> <span class="title">Controller</span> {</span> <span class="indent"> </span><span class="keyword" style="font-weight:bold;">public</span> <span class="function"><span class="keyword" style="font-weight:bold;">function</span> <span class="title" style="color:#990000;font-weight:bold;">send</span><span class="params">()</span> <span class="indent"> </span>{</span> <span class="indent"> </span><span class="indent"> </span><span class="variable" style="color:#008080;">$name</span> = <span class="string" style="color:#DD1144;">'学院君'</span>; <span class="indent"> </span><span class="indent"> </span><span class="variable" style="color:#008080;">$flag</span> = Mail::send(<span class="string" style="color:#DD1144;">'emails.test'</span>,[<span class="string" style="color:#DD1144;">'name'</span>=><span class="variable" style="color:#008080;">$name</span>],function(<span class="variable" style="color:#008080;">$message</span>){ <span class="indent"> </span><span class="indent"> </span><span class="indent"> </span><span class="variable" style="color:#008080;">$to</span> = <span class="string" style="color:#DD1144;">'1072155122@qq.com'</span>; <span class="indent"> </span><span class="indent"> </span><span class="indent"> </span><span class="variable" style="color:#008080;">$message</span> ->to(<span class="variable" style="color:#008080;">$to</span>)->subject(<span class="string" style="color:#DD1144;">'测试邮件'</span>); <span class="indent"> </span><span class="indent"> </span>}); <span class="indent"> </span><span class="indent"> </span><span class="keyword" style="font-weight:bold;">if</span>(<span class="variable" style="color:#008080;">$flag</span>){ <span class="indent"> </span><span class="indent"> </span><span class="indent"> </span><span class="keyword" style="font-weight:bold;">echo</span> <span class="string" style="color:#DD1144;">'发送邮件成功，请查收！'</span>; <span class="indent"> </span><span class="indent"> </span>}<span class="keyword" style="font-weight:bold;">else</span>{ <span class="indent"> </span><span class="indent"> </span><span class="indent"> </span><span class="keyword" style="font-weight:bold;">echo</span> <span class="string" style="color:#DD1144;">'发送邮件失败，请重试！'</span>; <span class="indent"> </span><span class="indent"> </span>} <span class="indent"> </span>} } |
Mail::send 需要传递三个参数，第一个是邮件视图，第二个是传入视图的数据，第三个是一个闭包，该闭包中定义了收件人、抄送人（如果有的话）、邮件主题、附件等信息。邮件的主体内容位于局部视图中，下面我们就来定义这个局部视图，在resources/views/emails 目录下新建 test.blade.php ，编辑其内容如下：
|
1 |
{{<span class="variable" style="color:#008080;">$name</span>}}，这是一封测试邮件 |
然后我们就可以在浏览器中访问 http://laravel.app:8000/mail/send 发送邮件，如果页面显示邮件发送成功，那么到收件人邮箱就能收到邮件了：
更简单的纯文本邮件发送
上面的示例仅仅是发送一个字符串，对于纯文本字符串邮件发送，还有更简单的方法：
|
1 2 |
Mail::raw(<span class="string" style="color:#DD1144;">'这是一封测试邮件'</span>, function (<span class="variable" style="color:#008080;">$message</span>) { <span class="variable" style="color:#008080;">$to</span> = <span class="string" style="color:#DD1144;">'1072155122@qq.com'</span>; <span class="variable" style="color:#008080;">$message</span> ->to(<span class="variable" style="color:#008080;">$to</span>)->subject(<span class="string" style="color:#DD1144;">'测试邮件'</span>); }); |
这样的话无需创建视图即可完成邮件发送。
发送带附件的邮件（中文乱码解决）
当然，邮件内容往往不仅仅是纯文本这么简单，有时候我们会在邮件中加上附件，那么这该如何实现呢？
先上代码：
|
1 2 |
<span class="variable" style="color:#008080;">$flag</span> = Mail::<span class="keyword" style="font-weight:bold;">send</span>(<span class="string" style="color:#DD1144;">'emails.test'</span>,[<span class="string" style="color:#DD1144;">'name'</span>=><span class="variable" style="color:#008080;">$name</span>],function(<span class="variable" style="color:#008080;">$message</span>){ <span class="indent"> </span><span class="variable" style="color:#008080;">$to</span> = <span class="string" style="color:#DD1144;">'1072155122@qq.com'</span>; <span class="indent"> </span><span class="variable" style="color:#008080;">$message</span>->to(<span class="variable" style="color:#008080;">$to</span>)->subject(<span class="string" style="color:#DD1144;">'测试邮件'</span>); <span class="indent"> </span><span class="variable" style="color:#008080;">$attachment</span> = storage_path(<span class="string" style="color:#DD1144;">'app/files/test.doc'</span>); <span class="indent"> </span><span class="regexp" style="color:#009926;">//</span>在邮件中上传附件 <span class="indent"> </span><span class="variable" style="color:#008080;">$message</span>->attach(<span class="variable" style="color:#008080;">$attachment</span>,[<span class="string" style="color:#DD1144;">'as'</span>=><span class="string" style="color:#DD1144;">'测试文档.doc'</span>]); }); |
从代码可知我们使用闭包中 $message 实例上的 attach 方法上传附件，该方法第一个参数是附件地址，第二个参数是一些额外参数，这里我们通过 as 指定附件在邮件中的显示名称。
注：需要注意的是 $message 实际上是 Illuminate\Mail\Message 的实例，我们可以在 $message 上调用 Message 类的所有方法。
再次访问 http://laravel.app:8000/mail/send 发送邮件，这样在收件箱中可以看到附件，但附件名称出现中文乱码，解决办法如下：
|
1 |
<span class="variable" style="color:#008080;">$message</span>->attach(<span class="variable" style="color:#008080;">$attachment</span>,[<span class="string" style="color:#DD1144;">'as'</span>=><span class="string" style="color:#DD1144;">"=?UTF-8?B?"</span>.base64_encode(<span class="string" style="color:#DD1144;">'测试文档'</span>).<span class="string" style="color:#DD1144;">"?=.doc"</span>]); |
通过这样处理后，就不会有中文乱码出现了：
发送带图片的邮件
embed
除了附件之外，有时候为了让邮件内容更丰富，还会在邮件内容中插入图片，我们固然可以在邮件视图中硬编码写入图片路径，但是这显然很笨重，灵活性很差，Laravel为我们提供了便捷方法——在视图中使用 $message 上的 embed 方法：
|
1 |
{{$name}}，这是一封测试邮件 <span class="tag" style="color:#000080;"><<span class="title">br</span>></span> <span class="tag" style="color:#000080;"><<span class="title">img</span> <span class="attribute" style="color:#008080;">src</span>=<span class="value" style="color:#DD1144;">"{{$message->embed($imgPath)}}"</span>></span> |
这里的 $message 就是上述邮件发送闭包中的 $message ，Laravel内部自动将该变量传递到邮件视图。当然我们还需要在控制器动作中传入 $imgPath 变量：
|
1 2 |
<span class="variable" style="color:#008080;">$name</span> = <span class="string" style="color:#DD1144;">'学院君'</span>; <span class="variable" style="color:#008080;">$imgPath</span> = <span class="string" style="color:#DD1144;">'http://laravelacademy.org/wp-statics/images/carousel/LaravelAcademy.jpg'</span>; <span class="variable" style="color:#008080;">$flag</span> = Mail::<span class="keyword" style="font-weight:bold;">send</span>(<span class="string" style="color:#DD1144;">'emails.test'</span>,[<span class="string" style="color:#DD1144;">'name'</span>=><span class="variable" style="color:#008080;">$name</span>,<span class="string" style="color:#DD1144;">'imgPath'</span>=><span class="variable" style="color:#008080;">$imgPath</span>],function(<span class="variable" style="color:#008080;">$message</span>){ <span class="indent"> </span><span class="variable" style="color:#008080;">$to</span> = <span class="string" style="color:#DD1144;">'1072155122@qq.com'</span>; <span class="indent"> </span><span class="variable" style="color:#008080;">$message</span>->to(<span class="variable" style="color:#008080;">$to</span>)->subject(<span class="string" style="color:#DD1144;">'测试邮件'</span>); <span class="indent"> </span><span class="variable" style="color:#008080;">$attachment</span> = storage_path(<span class="string" style="color:#DD1144;">'app/files/test.doc'</span>); <span class="indent"> </span><span class="regexp" style="color:#009926;">//</span>在邮件中上传附件 <span class="indent"> </span><span class="variable" style="color:#008080;">$message</span>->attach(<span class="variable" style="color:#008080;">$attachment</span>,[<span class="string" style="color:#DD1144;">'as'</span>=><span class="string" style="color:#DD1144;">"=?UTF-8?B?"</span>.base64_encode(<span class="string" style="color:#DD1144;">'测试文档'</span>).<span class="string" style="color:#DD1144;">"?=.doc"</span>]); }); |
在浏览器中访问 http://laravel.app:8000/mail/send 发送邮件，邮件发送成功后去收件箱查看：
由此可见，图片已经插入到邮件内容中。
embedData
此外还支持发送原生的图片数据到邮件中，即将本地图片读取到内存然后渲染到邮件视图，这可以通过 $message 上的 embedData 实现。
首先我们修改控制器动作如下：
|
1 2 |
<span class="variable" style="color:#008080;">$name</span> = <span class="string" style="color:#DD1144;">'学院君'</span>; <span class="regexp" style="color:#009926;">//</span><span class="variable" style="color:#008080;">$imgPath</span> = <span class="string" style="color:#DD1144;">'http://laravelacademy.org/wp-statics/images/carousel/LaravelAcademy.jpg'</span>; <span class="variable" style="color:#008080;">$image</span> = Storage::get(<span class="string" style="color:#DD1144;">'images/test.jpg'</span>); <span class="variable" style="color:#008080;">$flag</span> = Mail::<span class="keyword" style="font-weight:bold;">send</span>(<span class="string" style="color:#DD1144;">'emails.test'</span>,[<span class="string" style="color:#DD1144;">'name'</span>=><span class="variable" style="color:#008080;">$name</span>,<span class="string" style="color:#DD1144;">'image'</span>=><span class="variable" style="color:#008080;">$image</span>],function(<span class="variable" style="color:#008080;">$message</span>){ <span class="indent"> </span><span class="variable" style="color:#008080;">$to</span> = <span class="string" style="color:#DD1144;">'1072155122@qq.com'</span>; <span class="indent"> </span><span class="variable" style="color:#008080;">$message</span>->to(<span class="variable" style="color:#008080;">$to</span>)->subject(<span class="string" style="color:#DD1144;">'测试邮件'</span>); <span class="indent"> </span><span class="variable" style="color:#008080;">$attachment</span> = storage_path(<span class="string" style="color:#DD1144;">'app/files/test.doc'</span>); <span class="indent"> </span><span class="regexp" style="color:#009926;">//</span>在邮件中上传附件 <span class="indent"> </span><span class="variable" style="color:#008080;">$message</span>->attach(<span class="variable" style="color:#008080;">$attachment</span>,[<span class="string" style="color:#DD1144;">'as'</span>=><span class="string" style="color:#DD1144;">"=?UTF-8?B?"</span>.base64_encode(<span class="string" style="color:#DD1144;">'测试文档'</span>).<span class="string" style="color:#DD1144;">"?=.doc"</span>]); }); |
记得在 MailController 顶部加上 use Storage ，然后修改邮件视图test.blade.php 如下：
|
1 |
{{$name}}，这是一封测试邮件 <span class="tag" style="color:#000080;"><<span class="title">br</span>></span> <span class="tag" style="color:#000080;"><<span class="title">img</span> <span class="attribute" style="color:#008080;">src</span>=<span class="value" style="color:#DD1144;">"{{$message->embedData($image,'LaravelAcademy.jpg')}}"</span>></span> |
最后去浏览器中访问http://laravel.app:8000/mail/send发送邮件，邮件发送成功去收件箱查看邮件内容：
同样可以成功插入图片。
注意：
如果有提示
发送邮件失败 5.7.0 Must issue a STARTTLS command first 这个错误，尝试着改变端口，我就是把587改为 25就可以了，好坑。。
MAIL_PORT=25
