Laravel 邮件发送功能实现

背景

• 近期在接触传说中最优雅的 PHP 框架——Laravel，学习了一下邮件发送功能，在此分享一下，其中，我使用的框架版本为 5.2.45，参考时请注意差别.
• 对于 ThinkPHP 框架框架的邮件发送可参考文章 ThinkPHP 框架下邮件发送功能

别激动，我就是个背景图而已

功能开发过程

• 此处以 网易（163.com）邮箱为例。

一、前期准备

1).首先对 STMP 的知识稍作了解

STMP 简介 《百度百科》

2).开启邮箱 STMP 服务

以 163.com 邮箱为例，点击上方导航栏的“设置”，选择“POP3/SMTP/IMAP”进行下面的设置，着重记下服务器地址（SMTP服务器：smtp.163.com）

然后点击“客户端授权密码”进行权限设置，一般会进行短信的验证，并记录下自己设定的授权登录密码，后面的代码中需要用到。

二.代码实现

1).修改配置文件 mail.php

• 文件位置位于 config/mail.php
• 修改其中的 “from” 信息，以本人为例，address 为发送方邮箱账号，name 为称谓

 'from' => ['address' => '[email protected]', 'name' => '逗比2号'],

2).修改项目根目录下的配置文件 .env

MAIL_DRIVER=smtp
MAIL_HOST=smtp.163.com
MAIL_PORT=25
[email protected]
MAIL_PASSWORD=xxxxx
MAIL_ENCRYPTION=null

• 注意配置信息的填写：MAIL_USERNAME，MAIL_PASSWORD为前期准备中记下的163邮箱账号及客户端授权密码（非登录密码）
• MAIL_PORT 为默认端口号，如果配置 MAIL_ENCRYPTION = ssl 时，端口号需要更改为 465

3).补充路由信息

Route::any('mail', 'HomeController@mail');

4).控制器代码编写

• 基本的代码编辑如下
• 注意，本人发现网上的介绍有出入，有的是使用 Mail 类，推测应该是版本不同的原因，此处针对 5.2.45 版本进行测试

namespace App\Http\Controllers;
use Illuminate\Mail\Mailer;
class HomeController extends Controller
{
    private $mailer;
    public function __construct(Mailer $mailer)
    {
        $this->mailer = $mailer;
    }
    /**
     * 发送邮件 此方法选择进行邮件发送的方式
     */
    public function mail(){
       
        $tag = $this->sendText();
        //$tag = $this->sendHtml();
        //TODO  $tag 判断发送是否成功，进行后续代码开发
    }
    /**
     * 发送纯文本 邮件
     */
    public function sendText(){
        $tag = $this->mailer->raw('从前的日色变得慢 车 马 邮件 都慢',function ($message){
            $message->subject('这是邮件主题，希望您能支持');
            $message->to('[email protected]');
        });
        return $tag;
    }
    /**
     * 发送自定义网页
     */
    public function sendHtml(){
        $data = ['title' => '你若盛开，清风自来','author' => '木心'];
        $tag = $this->mailer->send('mail',$data,function ($message){
            $message->subject('Hello My Dear,let`s go');
            $message->to('[email protected]');
        });
        return $tag;
    }
}

三、代码说明

1).方法 sendText()

• 此方法为发送纯文本邮件的功能实现，调用此方法发送的邮件截图如下：

2).方法 sendHtml()

• 此方法为自定义格式邮件发送的功能实现
• 实现的前提需要有设计界面，代码中举例为我简单设计的 mail.blade.php 参考代码如下：

{{$title}}
![]({{asset('uploads/20170902/59aa05723e35d.jpg')}})
      从前的日色
        变得慢
      车 马 邮件
         都慢
    一生只够爱一个人
                --{{$author}}

• 调用此方法发送的邮件截图如下：

补充

1).另一种简单写法

• 其实可提供一种更简单的写法，与上面所处理的raw(),send()方法类似，举例：

use Illuminate\Support\Facades\Mail;

$tag = Mail::raw('你好，我们已经准备好了',function ($message){
            $message->to('[email protected]');
        });

• 不过，测试发现会有如下报错：

FatalErrorException
 in ClassLoader.php line 373:Maximum function nesting level of '100' reached, aborting!

• 但是前面的第一种代码方案，不会出现此问题，并且邮件发送响应快一些（或许错觉），然而，此代码如果放在队列中执行，测试发现不做任何修改也是可以实现...

• 原因和解决方案，请参考文章 - PHP中的函数嵌套层数限制

2).554 邮件发送报错

• 有时邮件发送时，会有如下报错，例如 554 多表示邮件发送过多被系统禁止了，具体信息可通过提示信息中的网址进行查询.

开发测试中的报错信息 参考

554 报错查询结果

• 具体代码可自行优化，有问题建议多多谷歌，还是能帮到不少忙的.
• See you !