Laravel5.0+ 邮件发送功能实现

I. 背景

  • 近期在接触传说中最优雅的 PHP 框架——Laravel,学习了一下邮件发送功能,在此分享一下
  • 测试环境:Laravel 5.2.45,Laravel 5.5
  • 使用协议:SMTP 邮件传输协议
  • 对于 ThinkPHP 框架框架的邮件发送可参考文章 ThinkPHP 框架下邮件发送功能

II. 功能开发过程

  • 此处以 网易(163.com)邮箱为例。

1、前期准备

(1).首先对 SMTP 的知识稍做了解

SMTP 简介  《百度百科》

(2).开启邮箱 SMTP 服务

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

  • 而后点击“客户端受权密码”进行权限设置,通常会进行短信的验证,并记录下本身设定的受权登陆密码,后面的代码中须要用到。

2、代码实现

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

  • 文件位置位于 config/mail.php
  • 修改其中的 “from” 信息,以本人为例,address 为发送方邮箱帐号,name 为称谓
'from' => ['address' => '1xxxxxxx@163.com', 'name' => '逗比2号'],

(2).修改配置文件 .env

MAIL_DRIVER=smtp
MAIL_HOST=smtp.163.com
MAIL_PORT=25
MAIL_USERNAME=1xxxxxxx@163.com
MAIL_PASSWORD=xxxxx
MAIL_ENCRYPTION=null
  • 注意配置信息的填写:MAIL_USERNAME,MAIL_PASSWORD 为前期准备中记下的163邮箱帐号及客户端受权密码(非登陆密码)php

  • MAIL_PORT 为默认端口号,若是配置 MAIL_ENCRYPTION = ssl 时,端口号须要更改成 465css

(3).补充路由信息

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

(4).控制器代码编写

  • 基本的代码编辑以下
  • 注意,本人发现网上的介绍有出入,有的是使用 Mail 类,推测应该是版本不一样的缘由,此处针对 5.2.4五、5.5 版本进行的测试
  • 附录 TestController.php 源代码以供参考
<?php namespace App\Http\Controllers; use Illuminate\Mail\Mailer; class TestController extends Controller { private $mailer; public function __construct(Mailer $mailer) { $this->mailer = $mailer; } /** * 发送邮件 */ public function mail(){ //测试数据 $viewData = ['title' => '你若怒放,清风自来','author' => '木心']; $emailData = [ 'content' => '从前的日色变得慢 车 马 邮件 都慢', 'subject' => '这是邮件主题,但愿您能支持!',//邮件主题 'addr' => 'xxxxxxxxx@qq.com',//邮件接收地址 ]; $this->sendText($emailData); //$this->sendHtml('mail',$viewData,$emailData); //TODO $tag 判断发送是否成功,进行后续代码开发 return view('mail',['title' => '你若怒放,清风自来','author' => '木心']); } /** * 发送纯文本 邮件 * @param $emailData 邮件数据 */ public function sendText($emailData){ //此处为文本内容 $tag = $this->mailer ->raw($emailData['content'], function ($message)use ($emailData){ $message->subject($emailData['subject']); $message->to($emailData['addr']); }); return $tag; } /** * 发送自定义网页 * @param $emailData 邮件数据 * @param $viewPage html视图 * @param $viewData html传输数据 */ public function sendHtml($viewPage,$viewData,$emailData){ $tag = $this->mailer ->send($viewPage,$viewData, function ($message) use ($emailData){ $message->subject($emailData['subject']); $message->to($emailData['addr']); }); return $tag; } } 

3、 代码说明

(1).方法 sendText()

  • 此方法为发送纯文本邮件的功能实现,调用此方法发送的邮件截图以下:

(2).方法 sendHtml()

  • 此方法为自定义格式邮件发送的功能实现
  • 实现的前提须要有设计界面,代码中举例为我简单设计的 mail.blade.php 参考代码以下:
<html>
<style> *{ font-family: 楷体; } </style>
<h2>{{$title}}</h2>
![]({{asset('uploads/20170902/59aa05723e35d.jpg')}})
<pre>
      从前的日色
        变得慢
      车 马 邮件
         都慢
    一辈子只够爱一我的
                --{{$author}}
</pre>
</html>
  • 调用此方法发送的邮件截图以下:

III. 补充

(1).另外一种简单写法

  • 其实可提供一种更简单的写法,与上面所处理的 raw(),send() 方法相似,举例:
use Illuminate\Support\Facades\Mail;

$tag = Mail::raw('你好,咱们已经准备好了',function ($message){
            $message->to('9xxxxxxxxxx@qq.com');
        });
  • 不过,测试发现会有以下报错:
FatalErrorException
 in ClassLoader.php line 373:Maximum function nesting level of '100' reached, aborting!
  • 可是前面的第一种代码方案,不会出现此问题,而且邮件发送响应快一些(或许错觉),然而,此代码若是放在队列中执行,测试发现不作任何修改也是能够实现…html

  • 缘由和解决方案,请参考文章 - PHP中的函数嵌套层数限制laravel

(2).554 邮件发送报错

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

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

554 报错查询结果

  • 具体代码可自行优化,有问题建议多多谷歌,仍是能帮到很多忙的.

(3). post 请求500报错

  • 注意一点:laravel框架默认要求表单提交时须要添加
{{ csrf_field() }}

♩♪♫♬♭♯♮‖¶♬§♮☍♭♫♩♬♫♯♭§¶‖♫☍☌◎♬¶♯♩‖♫♭☌☍♬…