ThinkPHP5 整合 PHPMailer 邮件发送完整指南

一、PHPMailer 安装与配置优化

1.1 更规范的安装方式（使用Composer）

composer require phpmailer/phpmailer

优势：

  • 自动处理依赖关系
  • 方便版本更新
  • 符合TP5的规范

1.2 手动安装的目录结构调整建议

extend/
└── PHPMailer/
    ├── src/
    │   ├── PHPMailer.php
    │   ├── SMTP.php
    │   └── Exception.php
    └── autoload.php

二、邮件服务封装优化

2.1 创建邮件服务类（推荐）

<?php
namespace app\common\service;

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\Exception;

class MailService
{
    protected $config = [
        'host'       => 'smtp.exmail.qq.com',
        'port'       => 465,
        'username'   => 'send@berfen.com',
        'password'   => 'your_password',
        'from'       => 'send@berfen.com',
        'from_name'  => 'BER分系统',
        'reply_to'   => '',
        'reply_name' => '',
        'charset'    => 'UTF-8',
        'debug'      => 0
    ];

    public function __construct($config = [])
    {
        $this->config = array_merge($this->config, $config);
    }

    public function send($to, $name, $subject, $body, $attachments = [])
    {
        $mail = new PHPMailer(true);
        
        try {
            // 服务器配置
            $mail->isSMTP();
            $mail->Host       = $this->config['host'];
            $mail->SMTPAuth   = true;
            $mail->Username   = $this->config['username'];
            $mail->Password   = $this->config['password'];
            $mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS;
            $mail->Port       = $this->config['port'];
            $mail->CharSet    = $this->config['charset'];
            $mail->SMTPDebug  = $this->config['debug'];

            // 收件人
            $mail->setFrom($this->config['from'], $this->config['from_name']);
            if ($this->config['reply_to']) {
                $mail->addReplyTo($this->config['reply_to'], $this->config['reply_name']);
            }
            $mail->addAddress($to, $name);

            // 内容
            $mail->isHTML(true);
            $mail->Subject = $subject;
            $mail->Body    = $body;
            $mail->AltBody = strip_tags($body);

            // 附件
            foreach ($attachments as $attachment) {
                if (is_file($attachment)) {
                    $mail->addAttachment($attachment);
                }
            }

            return $mail->send();
        } catch (Exception $e) {
            return "邮件发送失败: {$mail->ErrorInfo}";
        }
    }
}

三、模板邮件发送实现

3.1 创建邮件模板

<!-- application/view/email/template.html -->
<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>{$title}</title>
</head>
<body>
    <div style="font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto;">
        <h2 style="color: #333;">{$header}</h2>
        <div style="padding: 20px; background: #f5f5f5;">
            {$content}
        </div>
        <p style="text-align: center; color: #999;">
            © {$year} 公司名称. 保留所有权利
        </p>
    </div>
</body>
</html>

3.2 模板邮件发送方法

public function sendTemplateEmail($to, $name, $template, $data)
{
    $view = new \think\View();
    $html = $view->fetch($template, $data);
    
    $subject = $data['title'] ?? '系统邮件';
    return $this->send($to, $name, $subject, $html);
}

四、队列邮件发送（提高性能）

4.1 使用TP5的队列功能

// 创建邮件队列任务
namespace app\job;

use think\queue\Job;
use app\common\service\MailService;

class SendEmail
{
    public function fire(Job $job, $data)
    {
        $mailer = new MailService();
        $result = $mailer->send(
            $data['to'], 
            $data['name'], 
            $data['subject'], 
            $data['body'],
            $data['attachments'] ?? []
        );
        
        if ($result === true) {
            $job->delete();
            return true;
        }
        
        if ($job->attempts() > 3) {
            $job->delete();
            // 记录失败日志
        }
    }
}

4.2 调用队列发送邮件

// 在控制器中
\think\Queue::push('app\job\SendEmail', [
    'to' => 'www@berfen.com',
    'name' => '收件用户',
    'subject' => '队列邮件测试',
    'body' => '这是一封通过队列发送的测试邮件'
]);

五、常见邮件服务商配置

服务商 SMTP服务器 端口 加密方式
QQ邮箱 smtp.qq.com 465 SSL
163邮箱 smtp.163.com 465 SSL
Gmail smtp.gmail.com 587 TLS
企业微信 smtp.exmail.qq.com 465 SSL
Outlook smtp.office365.com 587 STARTTLS

六、错误排查指南

  1. 连接超时：

    • 检查防火墙设置
    • 确认端口未被屏蔽
    • 尝试Telnet测试端口连通性

  2. 认证失败：

    • 检查用户名密码
    • 确认是否开启SMTP服务
    • 检查是否有授权码要求

  3. 邮件被拒收：

    • 检查SPF/DKIM记录
    • 避免被识别为垃圾邮件
    • 添加邮件退订链接

七、安全性建议

  1. 配置保护：

    • 将SMTP密码存储在环境变量中
    • 不要将配置提交到版本库

  2. 内容安全：

    • 过滤HTML邮件中的危险标签
    • 对用户输入内容进行转义

  3. 频率限制：

    • 实现邮件发送速率限制
    • 避免被识别为垃圾邮件发送者

八、完整调用示例

// 在控制器中
public function sendTestEmail()
{
    $mailer = new \app\common\service\MailService();
    
    // 简单邮件
    $result = $mailer->send(
        'recipient@example.com',
        '测试用户',
        '邮件主题',
        '<h1>邮件内容</h1><p>这是一封测试邮件</p>'
    );
    
    // 模板邮件
    $templateData = [
        'title' => '欢迎邮件',
        'header' => '欢迎加入我们',
        'content' => '感谢您注册我们的服务...',
        'year' => date('Y')
    ];
    $result = $mailer->sendTemplateEmail(
        'recipient@example.com',
        '测试用户',
        'email/template',
        $templateData
    );
    
    if ($result === true) {
        return $this->success('邮件发送成功');
    }
    return $this->error('邮件发送失败: ' . $result);
}

标签: Web开发, 后端开发, ThinkPHP, ThinkPHP5, PHPMailer, SMTP配置, 邮件服务

添加新评论