I. 背景
- 近期在接触传说中最优雅的 PHP 框架——Laravel,学习了一下邮件发送功能,在此分享一下
- 测试环境:Laravel 5.2.45,Laravel 5.5
- 使用协议:SMTP 邮件传输协议
- 对于 ThinkPHP 框架框架的邮件发送可参考文章 ThinkPHP 框架下邮件发送功能
II. 功能开发过程
- 此处以 网易
(163.com)
邮箱为例。
一、前期准备
(1).首先对 SMTP 的知识稍作了解
(2).开启邮箱 SMTP 服务
- 以 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', 'TestController@mail');
(4).控制器代码编写
- 基本的代码编辑如下
- 注意,本人发现网上的介绍有出入,有的是使用 Mail 类,推测应该是版本不同的原因,此处针对 5.2.45、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;
}
}
三、 代码说明
(1).方法 sendText()
- 此方法为发送纯文本邮件的功能实现,调用此方法发送的邮件截图如下:
(2).方法 sendHtml()
- 此方法为自定义格式邮件发送的功能实现
- 实现的前提需要有设计界面,代码中举例为我简单设计的
mail.blade.php
参考代码如下:
<html>
<style>
*{
font-family: 楷体;
}
</style>
<h2>{{$title}}</h2>
![]({{asset('uploads/20170902/59aa05723e35d.jpg')}})
<pre>
从前的日色
变得慢
车 马 邮件
都慢
一生只够爱一个人
--{{$author}}
</pre>
</html>
- 调用此方法发送的邮件截图如下:
☞ 附录
①. 另一种简单写法
- 其实可提供一种更简单的写法,与上面所处理的 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中的函数嵌套层数限制
②. 554 邮件发送报错
- 有时邮件发送时,会有如下报错,例如 554 多表示邮件发送过多被系统禁止了,具体信息可通过提示信息中的网址进行查询.
- 具体代码可自行优化,有问题建议多多谷歌,还是能帮到不少忙的.
③. post 请求500报错
- 注意一点:laravel框架默认要求表单提交时需要添加
{{ csrf_field() }}
④. phpmailer 发送邮件成功了 但是用户就是没收到邮件
出现原因:发送邮件太多 导致邮箱服务器被腾讯封了 发送的邮件统统进入了邮件服务器的草稿箱里。
解决方案:
重新修改密码,更换授权码即可
⑤. PHP 使用 phpMailer 封装邮件发送方法)
(2024-01-09 补充)
- 首先,离线安装控件 -
phpMailer
(建议composer
命令安装)
- 封装核心方法如下:
/**
* @Notes:邮箱发送验证码
* @param string $email_url 邮件地址
* @param string $verif_code 验证码
* @param int $lang_type 语言类型 1:中文,2:泰文
* @return array
* @User: zhanghj
* @DateTime: 2023-12-15 18:54
*/
public static function sendPHPMailerVerCode($email_url = '',$verif_code = '',$lang_type = 1){
$sendFlag = false;
$retMsg = '';
includeFile(dirname(Yii::$app->basePath).'/common/PHPMailer/src/PHPMailer.php');
$mail = new PHPMailer(true);
if ($lang_type == 2){
//泰文版
$host_com = 'smtp.exmail.qq.com';
$from_email = 'thailand@hwappu.com';
$email_userName = 'thailand@hwappu.com'; // SMTP 用户名 即邮箱的用户名
$email_password = 'Thaicust&123';
$subject_str = 'รหัสยืนยันอีเมล';
$body_content = "เรียนผู้ใช้............สวัสดีครับ/ค่ะ<br>";
$body_content .= "รหัสยืนยันของคุณคือ:$verif_code<br>";
$body_content .= "อย่าเปิดเผยรหัสยืนยันของคุณกับผู้อื่น<br><br>";
$body_content .= "ข้อความนี้เป็นข้อความอัตโนมัติและไม่สามารถตอบกลับได้<br>";
$body_content .= "ขอขอบคุณสำหรับการเข้าใช้งานและขอให้คุณมีความสุขในการใช้งาน";
$alt_body = 'เนื้อหาเมลไม่รองรับการแสดงผล';
}else{
$host_com = 'smtp.exmail.qq.com';
$from_email = 'lvluo@huapush.net';
$email_userName = 'lvluo@huapush.net'; // SMTP 用户名 即邮箱的用户名
$email_password = '123456@Dong';
$subject_str = '邮箱验证码';
//中文版邮件
$body_content = "尊敬的用户,您好!<br><br>";
$body_content .= "您的验证码是:$verif_code <br>";
$body_content .= "请勿将验证码透露给其他人。<br><br>";
$body_content .= "本邮件由系统自动发送,请勿直接回复!<br>";
$body_content .= "感谢您的访问,祝您使用愉快";
$alt_body = '邮件内容不支持显示';
}
try {
//服务器配置
$mail->CharSet ="UTF-8"; //设定邮件编码
$mail->SMTPDebug = 0; // 调试模式输出
$mail->isSMTP(); // 使用SMTP
$mail->Host = $host_com; // SMTP服务器
$mail->SMTPAuth = true; // 允许 SMTP 认证
$mail->Username = $email_userName; // SMTP 用户名 即邮箱的用户名
$mail->Password = $email_password; // SMTP 密码 部分邮箱是授权码(例如163邮箱)
$mail->SMTPSecure = 'ssl'; // 允许 TLS 或者ssl协议
$mail->Port = 465; // 服务器端口 25 或者465 具体要看邮箱服务器支持
$mail->setFrom($from_email, 'HWAPPU'); //发件人
$mail->addAddress($email_url, 'Dear Friend'); // 收件人
//$mail->addAddress('ellen@example.com'); // 可添加多个收件人
//$mail->addReplyTo('xxxx@163.com', 'info'); //回复的时候回复给哪个邮箱 建议和发件人一致
//$mail->addCC('cc@example.com'); //抄送
//$mail->addBCC('bcc@example.com'); //密送
//发送附件
// $mail->addAttachment('../xy.zip'); // 添加附件
// $mail->addAttachment('../thumb-1.jpg', 'new.jpg'); // 发送附件并且重命名
$mail->isHTML(true); // 是否以HTML文档格式发送 发送后客户端可直接显示对应HTML内容
$mail->Subject = $subject_str;
$mail->Body = $body_content;
$mail->AltBody = $alt_body;
$mail->send();
$sendFlag = true;
}catch (\Exception $exception){
$retMsg = $exception->getMessage();
}
return [$sendFlag,$retMsg];
}
- 执行效果如下: