ThinkPHP5 封装邮件发送服务（可发附件）

Posted 2020-10-04 mingc

一、 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\' => \'[e-mail]\',  // SMTP登录邮箱
	\'password\' => \'yourpassword\',          // SMTP登录密码。126邮箱使用客户端授权码，QQ邮箱用独立密码
	\'from\' => \'[e-mail]\',          // 发件人邮箱
	\'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(\'[e-mail]\', \'mingc\', \'邮件来了\', \'<p style="color: #f60; font-weight: 700;">恭喜，邮件成功!</p>\', \'C:/Users/Administrator/Desktop/body.bmp\');
    var_dump($ok);
}

　　

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

 

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