ThinkPHP邮件发送功能实现-ThinkPHP-PHP中文网

thinkphp 6 使用 think-mail 需手动注册 facade 别名、显式设置 html 邮件编码、适配服务器 smtp 限制、分批发送并配置 spf/dkim 等邮件送达关键项。

thinkphp邮件发送功能实现

ThinkPHP 6 配置 `think-mail` 扩展后仍报错 `Class 'topthink hink_mailacadeMail' not found`

这是最常见的引入失败问题，根本原因不是没装包，而是没注册门面（Facade）别名。ThinkPHP 6 默认不自动加载第三方 Facade，必须手动在 config/app.php 的 'alias' 数组里加一行：

'think\Mail' => 	opthink	hink_mailFacade::class,

注意路径大小写和双反斜杠；如果用的是 Composer 安装的 topthink/think-mail，确认已执行 composer dump-autoload -o；若项目启用了类映射优化（如 Swoole 环境），还需检查是否缓存了旧的 autoload 文件。

使用 `Mail::send()` 发送 HTML 邮件时收件方看到的是纯文本或乱码

核心问题是未显式设置 Content-Type 和字符编码。ThinkPHP 的 think-mail 底层用的是 PHPMailer，但默认不启用 HTML 模式。必须调用 isHtml(true) 并指定编码：

Mail::to('user@example.com')
    ->subject('欢迎注册')
    ->message('<h2>您好</h2><p>这是一封 <strong>HTML</strong> 邮件</p><div class="aritcle_card flexRow artxards">
											<div class="artcardd flexRow">
												<a class="aritcle_card_img" rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
														src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
												<div class="aritcle_card_info flexColumn">
													<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="overflowclass">btpanel phpsite 宝塔面板PHP网站</a>
													<p class="overflowclass">宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
												</div>
												<a rel="nofollow" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
												</a>
											</div>
										</div>', 'text/html; charset=utf-8')
    ->isHtml(true)
    ->send();

message() 第二个参数是 MIME 类型字符串，不能只传 'html' 或留空
若用模板渲染内容，确保模板输出不含 BOM 头，否则 Outlook 等客户端会显示异常
Gmail 对内联样式支持弱，避免用 <style></style> 标签，优先用行内 style=""

本地开发能发、上线后 SMTP 连接超时或被拒绝

多数情况是服务器屏蔽了 SMTP 出站端口（尤其是 25、465、587），或云主机厂商限制了外发邮件。验证和应对方式如下：

用 telnet smtp.qq.com 587 测试连通性（Linux/macOS），Windows 可用 Test-NetConnection smtp.qq.com -Port 587
配置中改用 TLS 而非 SSL：把 'smtp_ssl' => true 改为 'smtp_secure' => 'tls'，并确保端口设为 587
阿里云/腾讯云轻量应用服务器默认禁用 25 端口，必须提工单申请解封，或改用其提供的邮件推送服务（如腾讯云 SES）
QQ 邮箱需开启「SMTP 服务」并使用「授权码」而非登录密码，授权码在邮箱设置 → 账户 → POP3/IMAP/SMTP/Exchange 设置里生成