背景
- 近期在接触传说中最优雅的 PHP 框架——Laravel,学习了一下邮件发送功能,在此分享一下,其中,我使用的框架版本为 5.2.45,参考时请注意差别.
- 对于 ThinkPHP 框架框架的邮件发送可参考文章 ThinkPHP 框架下邮件发送功能
功能开发过程
- 此处以 网易(163.com)邮箱为例。
一、前期准备
1).首先对 STMP 的知识稍作了解
2).开启邮箱 STMP 服务
以 163.com 邮箱为例,点击上方导航栏的“设置”,选择“POP3/SMTP/IMAP”进行下面的设置,着重记下服务器地址(SMTP服务器:smtp.163.com)
然后点击“客户端授权密码”进行权限设置,一般会进行短信的验证,并记录下自己设定的授权登录密码,后面的代码中需要用到。
二.代码实现
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邮箱账号及客户端授权密码(非登录密码)
- 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('9xxxxxxx@qq.com');
});
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('9xxxxxxxx@qq.com');
});
return $tag;
}
}
三、代码说明
1).方法 sendText()
- 此方法为发送纯文本邮件的功能实现,调用此方法发送的邮件截图如下:
2).方法 sendHtml()
- 此方法为自定义格式邮件发送的功能实现
- 实现的前提需要有设计界面,代码中举例为我简单设计的 mail.blade.php 参考代码如下:
<html>
<style>
*{
font-family: 楷体;
}
</style>
<h2>{{$title}}</h2>
![]({{asset('uploads/20170902/59aa05723e35d.jpg')}})
<pre>
从前的日色
变得慢
车 马 邮件
都慢
一生只够爱一个人
--{{$author}}
</pre>
</html>
- 调用此方法发送的邮件截图如下:
补充
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!
但是前面的第一种代码方案,不会出现此问题,并且邮件发送响应快一些(或许错觉),然而,此代码如果放在队列中执行,测试发现不做任何修改也是可以实现...
原因和解决方案,请参考文章 - PHP中的函数嵌套层数限制
2).554 邮件发送报错
- 有时邮件发送时,会有如下报错,例如 554 多表示邮件发送过多被系统禁止了,具体信息可通过提示信息中的网址进行查询.
- 具体代码可自行优化,有问题建议多多谷歌,还是能帮到不少忙的.
- See you !