ThinkPHP中集成PHPMailer需将三个核心文件放入extend/phpmailer/并重命名、加命名空间；配置SMTP参数使用授权码；封装send_mail()函数实现复用；控制器调用时传入收件人、主题、内容；调试时启用SMTPDebug并检查SSL、端口连通性及授权码。
一、在ThinkPHP项目中引入PHPMailer类库
PHPMailer需以兼容方式集成至ThinkPHP框架中，避免命名空间冲突与类加载失败。不同ThinkPHP版本对类库路径和命名规范要求不同，必须按版本适配文件位置与命名。
1、进入项目根目录下的extend目录（ThinkPHP5/6标准扩展目录）。
2、新建子目录phpmailer，用于存放PHPMailer核心文件。
3、从PHPMailer官方GitHub仓库下载v6.x完整包，解压后提取src/PHPMailer.php、src/SMTP.php、src/Exception.php三个文件。
立即学习“PHP免费学习笔记（深入）”；
4、将上述三个文件复制到extend/phpmailer/目录下，并重命名为phpmailer.php、smtp.php、exception.php（去除src/层级，统一小写命名，符合ThinkPHP自动加载规范）。
5、在每个文件首行添加命名空间声明：namespace phpmailer;。
二、配置SMTP邮件服务参数
邮件发送依赖外部SMTP服务器，需在ThinkPHP配置中明确指定服务器地址、端口、认证方式及凭据。使用授权码而非邮箱登录密码是关键安全要求，尤其对163、QQ等主流邮箱。
1、在config/mail.php中创建配置数组（若不存在则新建）：
2、填入如下结构化配置项：
'host' => 'smtp.163.com',
'port' => 465,
'smtp_auth' => true,
'smtp_secure' => 'ssl',
'username' => 'yourname@163.com',
'password' => '此处填写163邮箱客户端授权码，非登录密码',
'from' => 'yourname@163.com',
'from_name' => '系统通知中心',
'charset' => 'UTF-8',
'is_html' => true,
三、编写可复用的邮件发送函数
封装独立函数可提升代码复用性与可维护性，避免控制器中重复初始化PHPMailer实例。该函数需支持单收件人、多收件人、HTML内容及异常捕获。
1、在app/common.php或extend/helper.php中定义函数send_mail()。
2、函数内使用use phpmailer\phpmailer;导入类。
3、实例化new phpmailer();并禁用调试模式：$mail->SMTPDebug = 0;。
4、调用config('mail.*')动态加载配置项，逐项赋值给$mail对象属性。
5、设置发件人：$mail->setFrom(config('mail.from'), config('mail.from_name'));。
6、遍历收件人数组（支持字符串或数组），对每个地址调用$mail->addAddress($addr);。
7、设置邮件正文编码与格式：$mail->CharSet = config('mail.charset');，$mail->isHTML(config('mail.is_html'));。
8、调用$mail->send()，成功返回true，失败捕获Exception并返回false。
四、在控制器中调用发送逻辑
控制器负责接收业务参数并触发邮件行为，应与发送函数解耦。通过传入结构化数据实现灵活调用，例如验证码、注册通知、密码重置等场景均复用同一入口。
1、在控制器顶部添加命名空间引用：use think\Controller;。
2、定义方法如public function sendVerifyCode()。
3、获取请求参数：$email = $this->request->param('email');。
4、生成随机验证码并存入缓存：cache('verify_'.$email, $code, 300);。
5、构造邮件内容数组：$data = ['to' => $email, 'subject' => '邮箱验证码', 'body' => '您的验证码是：<strong><font color="green">'.$code.'</font></strong>，5分钟内有效。'];。
6、调用封装函数：$result = send_mail($data['to'], $data['subject'], $data['body']);。
7、根据$result返回JSON响应：return json(['code'=> $result ? 1 : 0, 'msg'=> $result ? '已发送' : '发送失败']);。
五、处理常见错误与调试手段
PHPMailer在集成过程中易因SSL扩展缺失、防火墙拦截、授权码错误或DNS解析失败而中断。启用调试模式可快速定位问题根源，但生产环境必须关闭。
1、临时开启调试：在发送前设置$mail->SMTPDebug = 2;，输出详细连接日志至页面。
2、检查PHP是否启用openssl扩展：在phpinfo()中确认OpenSSL support enabled。
3、验证SMTP端口连通性：使用telnet smtp.163.com 465测试网络可达性。
4、确认php.ini中allow_url_fopen = On且未禁用fsockopen函数。
5、若报错SMTP connect() failed，优先核查password字段是否误填为邮箱登录密码——必须使用163/qq邮箱后台开通的“客户端授权码”。
