ThinkPHP 本身无“事件自动发邮件”内置机制，需手动在事件监听器中调用封装好的邮件服务类；常见报错因 Mail 门面未在事件上下文注册或未正确绑定容器，须用 PHPMailer 实例或自定义 EmailService 并注意 CLI 环境下的路径、编码、时区问题。

直接说结论：ThinkPHP 本身没有“事件自动发邮件”的内置机制，所谓“事件发邮件”是开发者手动在事件监听器或中间件里调用邮件服务——不是框架自动做的，而是你得写代码把事件和 Mail 或 PHPMailer 实例串起来。

为什么 TP6 的事件监听器里调不到 Mail 类？

常见现象是：Class 'think\Mail' not found 或 Call to undefined method think\Mail::to()。这不是事件系统的问题，而是类加载和依赖注入没对上。

• think\Mail 是 topthink/think-mailer 扩展提供的门面（Facade），它只在控制器、命令行、HTTP 请求上下文中被自动注册；事件监听器属于异步/后台执行场景，Facade 不自动可用
• 如果你用的是原生 phpmailer/phpmailer，那根本不存在 think\Mail，必须自己 new PHPMailer\PHPMailer\PHPMailer
• TP6 默认不把 Mail 绑定到容器，所以不能直接 app()->make('mail') —— 得先在 app/provider.php 里手动绑定，或者改用 new Mail()（前提是已正确引入）

Event::listen 中发送邮件的实操写法

别在监听器里硬编码 SMTP 配置，也别直接 new PHPMailer 后反复 set 各种参数。推荐封装一个可复用的邮件服务类，再在监听器中调用它。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

• 先确保已安装：运行 composer require phpmailer/phpmailer（v6.9+），删掉任何手写的 class.phpmailer.php
• 创建 app/service/EmailService.php，构造函数里只读配置：config('mail.host')、config('mail.password') 等，不 new PHPMailer 实例
• 监听器中这样写：

  use app\service\EmailService;
  use think\Event;
  
  Event::listen('user.registered', function ($user) {
      (new EmailService())->sendWelcome($user['email'], $user['name']);
  });

• 关键点：邮件内容、收件人、主题这些动态数据必须由事件触发时传入，不能在服务类里写死 $this->addAddress('admin@example.com')

附件路径乱码、HTML 渲染失败、中文发件名变问号？

这些不是事件机制的问题，而是 PHPMailer 在非 HTTP 上下文里缺失环境支撑导致的。

立即学习“PHP免费学习笔记（深入）”；

• 附件路径含中文：PHPMailer 内部用 is_file() 判断，但 CLI 模式下当前工作目录可能不是项目根目录，相对路径失效 → 必须用 realpath() 转成绝对路径再传给 AddAttachment()
• HTML 邮件显示为源码：漏了 $mail->isHTML(true)；或用了 $mail->Body = $html 却没设 $mail->CharSet = 'utf-8'
• 发件人名称乱码：QQ/163 邮箱对 setFrom() 的第二个参数（名称）要求严格，必须用 mb_encode_mimeheader() 编码，例如：mb_encode_mimeheader('张三', 'UTF-8', 'B')
• 时区影响时间戳：CLI 脚本默认时区可能是 UTC，而邮箱服务器校验证书时会比对本地时间 → 在服务类构造函数开头加 date_default_timezone_set('Asia/Shanghai')

真正难调的不是“怎么写”，而是“在哪写”——事件监听器跑在命令行、队列、还是 HTTP 请求里，决定了你能用哪些类、哪些配置、甚至能不能解析 DNS。别假设所有环境都一样，每次换部署方式（Docker / 宝塔子目录 / 云函数）都得重验一次 SMTP 连通性。