thinkphp 6.1 不自带邮件功能，think\facade\mail 是空壳，调用 mail::send() 会报未定义方法错误；必须用 composer 安装 phpmailer v6.9+ 并手动封装 emailservice。
ThinkPHP 6.1 默认不带邮件发送能力，必须手动集成 PHPMailer，并绕过框架内置的 think\facade\Mail（它在 TP6.1 中未启用且无默认驱动）。直接用 mail() 函数或裸写 SMTP 逻辑风险高、难维护，正确路径是引入 PHPMailer 并封装为可复用的服务。
为什么不能用 TP6.1 自带的 Mail 门面？
TP6.1 的 think\facade\Mail 是空壳，没有绑定任何邮件驱动，调用 Mail::send() 会直接报 Call to undefined method think\facade\Mail::send()。官方文档中提到的 Mail 功能实际属于 TP5 或 TP8，TP6.1 未实现该组件——这是最常被踩的“以为能用结果全报错”的坑。
如何正确安装并初始化 PHPMailer？
使用 Composer 安装稳定版 PHPMailer（推荐 v6.9+，兼容 PHP 7.4–8.2）：
composer require phpmailer/phpmailer:^6.9
安装后，在 app/service/EmailService.php 中创建轻量封装类（不依赖容器自动注入，避免调试时找不到实例）：
<?php namespace app\service;
use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
class EmailService
{
public function send($to, $subject, $body)
{
$mail = new PHPMailer(true);
try {
$mail->isSMTP();
$mail->Host = config('email.host', 'smtp.qq.com');
$mail->SMTPAuth = true;
$mail->Username = config('email.username');
$mail->Password = config('email.password');
$mail->SMTPSecure = PHPMailer::ENCRYPTION_SMTPS; // QQ/163 用 SSL；Gmail 用 TLS
$mail->Port = config('email.port', 465);
$mail->setFrom(config('email.from'), config('email.name', '系统'));
$mail->addAddress($to);
$mail->isHTML(true);
$mail->Subject = $subject;
$mail->Body = $body;
return $mail->send();
} catch (\Exception $e) {
\think\facade\Log::error('Email send failed: ' . $e->getMessage());
return false;
}
}
}
关键点：
-
config('email.xxx')的值需从.env加载，不是config/mail.php（TP6.1 没这个配置文件） -
SMTPSecure必须与Port匹配：465 →ENCRYPTION_SMTPS，587 →ENCRYPTION_STARTTLS - QQ 邮箱等要求开启「SMTP 服务」并使用「授权码」而非登录密码，这个细节漏掉就永远连不上
如何在 .env 中安全配置邮箱参数？
在项目根目录 .env 文件中添加以下字段（注意：不要加引号包裹值，除非值含空格）：
EMAIL_HOST=smtp.qq.com EMAIL_USERNAME=yourname@qq.com EMAIL_PASSWORD=your_app_authorization_code EMAIL_PORT=465 EMAIL_FROM=yourname@qq.com EMAIL_NAME=MyApp
然后确保 APP_DEBUG=true 开启，否则配置读取失败也不会报错；修改 .env 后必须清空 runtime/cache/，否则旧缓存会锁住旧配置。
若用 163 邮箱，EMAIL_HOST 改为 smtp.163.com，端口仍为 465，但需确认账号已开启 SMTP 并生成授权码（不是邮箱登录密码）。
发送前必须验证的三个硬性条件
缺一不可，否则必失败：
- PHP 必须启用
openssl和sockets扩展（php -m | grep -E "openssl|sockets"验证） - 服务器出站 465/587 端口未被防火墙或云厂商安全组拦截（本地测试成功但线上失败，90% 是这个原因）
-
runtime目录可写，否则 PHPMailer 日志无法落盘，错误只能靠try/catch捕获
最后提醒：别在控制器里直接 new PHPMailer —— 把连接、认证、重试逻辑全耦合进去，下次换邮箱服务商就得改七八个文件。用服务类封装一次，后面所有发信都只调一行 (new EmailService())->send(...)，这才是 TP6.1 下可持续的做法。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
