ThinkPHP5 封装邮件发送服务(可带附件)

时间:2022-05-28 18:28:15

一、 Composer 安装 phpmailer

composer require phpmailer/phpmailer

二、ThinkPHP 中封装邮件服务类

我把它封装在扩展目录 extend/Mail.php 文件里,内容如下:

<?php
/**
* 邮件服务类
*/
class Mail extends \PHPMailer
{
function __construct()
{
date_default_timezone_set('PRC'); // 默认时区设置 $this->CharSet = config('mail.charset'); // 邮件编码设置
$this->isSMTP(); // 启用SMTP服务
$this->SMTPDebug = config('mail.smtp_debug'); // Debug模式级别
$this->Debugoutput = config('mail.debug_output'); // Debug输出类型
$this->Host = config('mail.host'); // SMTP服务器地址
$this->Port = config('mail.port'); // 端口号
$this->SMTPAuth = config('mail.smtp_auth'); // SMTP登录认证
$this->SMTPSecure = config('mail.smtp_secure'); // SMTP安全协议
$this->Username = config('mail.username'); // SMTP登录邮箱
$this->Password = config('mail.password'); // SMTP登录密码
$this->setFrom(config('mail.from'), config('mail.from_name')); // 发件人邮箱和名称
$this->addReplyTo(config('mail.reply_to'), config('mail.reply_to_name')); // 回复邮箱和名称
} /**
* 发送邮件
* @param [type] $toMail 收件人地址
* @param [type] $toName 收件人名称
* @param [type] $subject 邮件主题
* @param [type] $content 邮件内容,支持html
* @param [type] $attachment 附件列表。文件路径或路径数组
* @return [type] 成功返回true,失败返回错误消息
*/
function sendMail($toMail, $toName, $subject, $content, $attachment = null)
{
$this->addAddress($toMail, $toName);
$this->Subject = $subject;
$this->msgHTML($content); if($attachment) { // 添加附件
if(is_string($attachment)){
is_file($attachment) && $this->AddAttachment($attachment);
}
else if(is_array($attachment)){
foreach ($attachment as $file) {
is_file($file) && $this->AddAttachment($file);
}
}
} if(!$this->send()){ // 发送
return $this->ErrorInfo;
}
else{
return true;
}
}
}

  

注意:如果发送附件,建议使用英文路径。中文路径可能会导致附件发送失败,收到的邮件没有附件。

上面需要的一些配置参数,我把它们放在扩展配置目录 application/extra/mail.php 文件里 ,内容如下:

<?php
/**
* 邮件服务相关配置
*/
return [
'charset' => 'utf-8', // 邮件编码
'smtp_debug' => 0, // Debug模式。0: 关闭,1: 客户端消息,2: 客户端和服务器消息,3: 2和连接状态,4: 更详细
'debug_output' => 'html', // Debug输出类型。`echo`(默认),`html`,或`error_log`
'host' => 'smtp.126.com', // SMTP服务器地址
'port' => 465, // 端口号。默认25
'smtp_auth' => true, // 启用SMTP认证
'smtp_secure' => 'ssl', // 启用安全协议。''(默认),'ssl'或'tls',留空不启用
'username' => 'yourname@example.com', // SMTP登录邮箱
'password' => 'yourpassword', // SMTP登录密码。126邮箱使用客户端授权码,QQ邮箱用独立密码
'from' => 'from@example.com', // 发件人邮箱
'from_name' => 'name', // 发件人名称
'reply_to' => '', // 回复邮箱的地址。留空取发件人邮箱
'reply_to_name' => '', // 回复邮箱人名称。留空取发件人名称
];

  

注意:一般默认端口 25。如果使用了安全协议 ssl,那么端口号一般是 465 或 587。譬如 126 邮箱。建议使用安全协议,因为像阿里云服务器就禁止了非安全协议的 25 端口。

更多配置参数,可以看看源码:https://github.com/PHPMailer/PHPMailer/blob/master/class.phpmailer.php

三、测试

在控制器里方法里,添加测试代码:

public function mail()
{
$mail = new \Mail;
$ok = $mail->sendMail('xxxxxxxxx@qq.com', 'mingc', '邮件来了', '<p style="color: #f60; font-weight: 700;">恭喜,邮件成功!</p>', 'C:/Users/Administrator/Desktop/body.bmp');
var_dump($ok);
}

  

这里我使用 126 邮箱,安全协议 ssl,端口号 465,发送 html 内容,测试成功:

ThinkPHP5 封装邮件发送服务(可带附件)

参考链接:phpmail 的 SMTP 邮件实例