前言用 PHP 发邮件大概率会经历这三个阶段先写一行mail()觉得真简单然后发现邮件根本没发出去或者安静地躺在收件人的垃圾箱里最后翻遍资料才知道要用 SMTPSimple Mail Transfer Protocol连第三方邮件服务。mail()失败的原因其实很朴素它把邮件交给本机的邮件传输代理MTA例如 sendmail、postfix。而绝大多数 PHP 运行环境容器、云主机、共享空间里根本没有装 MTA也没有配置函数返回false或者干脆被disable_functions禁掉。就算本机有 MTA从家用宽带或云主机动态 IP 直发外网 25 端口也基本会被对方拒收。所以正确的做法是让 PHP 通过 SMTP 登录到专业的邮件服务商由它代发。本文用目前 PHP 生态里最常用的PHPMailer演示从安装、配置、发送 HTML 邮件与附件到排查「发出去了却进垃圾箱」的完整流程。示例基于PHP 8.5PHPMailer6.x 在 PHP 8.5 上可直接使用。一、先选路mail()、SMTP 客户端库怎么选方式依赖适合场景主要问题mail()本机 MTA有自建邮件服务器的内网系统容器里通常不存在 MTAPHPMailerComposer 包纯 PHP绝大多数业务邮件需要服务商账号Symfony MailerComposer 包已用 Symfony 全家桶的项目引入的组件较多邮件服务商 HTTP API只需curl只需发通知、要送达报告与 SMTP 语义不同需另写封装推荐PHPMailer成熟、文档全、纯 PHP 实现不需要任何扩展编译PHP 8.5 发布后只需composer update。composer require phpmailer/phpmailer二、SMTP 的三个关键参数连接任何 SMTP 服务要弄清楚的就三件事主机、端口、加密方式。端口与加密方式是绑定的配错了典型的症状是「卡住不返回最后超时」端口加密方式PHPMailer 常量说明587STARTTLS先明文握手再升级PHPMailer::ENCRYPTION_STARTTLS现代服务商的首选465隐式 TLS连上即加密PHPMailer::ENCRYPTION_SMTPS老式 SSL 端口仍被广泛支持25通常不加密空字符串多数云厂商已封禁出站 25 端口常见误配端口填 465 却设成STARTTLS客户端会一直等对方发明文握手问候而对方在等 TLS 握手双方互等直到超时。这是「SMTP connect() failed」里最隐蔽的一类。?php declare(strict_types1); use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\SMTP; use PHPMailer\PHPMailer\Exception; function makeMailer(string $host, int $port, string $user, string $pass): PHPMailer { $mail new PHPMailer(true); // true 出错时抛异常 $mail-isSMTP(); $mail-Host $host; $mail-Port $port; $mail-SMTPAuth true; $mail-Username $user; // 通常是完整邮箱地址 $mail-Password $pass; // 多数服务商要求「授权码」而不是登录密码 // 端口决定加密方式两者必须配对 $mail-SMTPSecure $port 465 ? PHPMailer::ENCRYPTION_SMTPS : PHPMailer::ENCRYPTION_STARTTLS; $mail-CharSet UTF-8; // 中文主题与正文必须显式设置 $mail-Timeout 10; // 单次连接超时秒避免请求被拖死 $mail-XMailer ; // 不暴露客户端版本信息 return $mail; }三个细节值得展开CharSet UTF-8不设置时 PHPMailer 默认使用iso-8859-1中文主题会变成乱码。用mail()手拼 header 时这个问题更常见因为编码方式要自己写。Password通常是授权码QQ 邮箱、163、企业邮箱等服务商都要求先在后台开启 SMTP 并生成独立的授权码直接用登录密码会认证失败。SMTPSecure与Port必须配对见上方表格。三、发一封完整的邮件HTML 正文 附件 抄送?php declare(strict_types1); use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\Exception; function sendOrderNotice(array $order): bool { $mail makeMailer( smtp.example.com, 587, noreplyexample.com, getenv(MAIL_AUTH_CODE) ?: ); try { // 发件人必须与 SMTP 账号属于同一域名否则 SPF/DKIM 对不上容易被判为垃圾邮件 $mail-setFrom(noreplyexample.com, 示例商城); $mail-addAddress($order[email], $order[name]); $mail-addReplyTo(supportexample.com, 客服); // 这里用纯文本正文演示HTML 正文的写法见本节末尾说明 $mail-isHTML(false); $mail-Subject 订单 . $order[id] . 已发货; $mail-Body implode(\n, [ 您好 . $order[name], 您的订单 . $order[id] . 已发货金额 . number_format((float) $order[amount], 2) . 元。, 如有疑问请直接回复本邮件。, ]); // 附件用「文件路径 显示名」不要用「文件内容 名字」的重载 $invoice __DIR__ . /invoices/ . $order[id] . .pdf; if (is_readable($invoice)) { $mail-addAttachment($invoice, invoice- . $order[id] . .pdf); } $mail-send(); return true; } catch (Exception $e) { // ErrorInfo 是字符串比异常消息更贴近底层原因 error_log(邮件发送失败 . $mail-ErrorInfo); return false; } }如果正文要带样式、按钮或表格把isHTML(true)打开并给Body赋 HTML 片段同时必须填写AltBody同样内容的纯文本版。这里有两个硬性要求所有插值必须转义。用htmlspecialchars($value, ENT_QUOTES, UTF-8)包住每一个用户数据用户昵称里带一个尖括号就能把整封邮件的版式打乱甚至被邮件网关判定为钓鱼内容。AltBody不能省。只有 HTML 正文的邮件在部分客户端显示不全反垃圾系统的评分也会更差。四、排查让 PHPMailer 把协议对话打出来发送不成功时最快的手段是打开调试输出。SMTPDebug会打印完整的 SMTP 对话过程EHLO、AUTH、MAIL FROM、DATA……一眼就能看出是卡在哪一步?php declare(strict_types1); use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\SMTP; $mail makeMailer(smtp.example.com, 587, noreplyexample.com, auth-code); // 2 客户端与服务端的往返对话3 再加上连接细节 $mail-SMTPDebug SMTP::DEBUG_SERVER; // 调试输出默认直接 echo 到响应体里正式代码中务必重定向到日志 $mail-Debugoutput static function (string $str, int $level): void { error_log([SMTP] . trim($str)); };读日志的对照表日志停在哪含义处理方向Connection refused端口不对或被防火墙拦换 587/465检查出站规则卡在CLIENT - SERVER: EHLO之后无响应加密方式与端口不匹配465 配SMTPS587 配STARTTLS535 Authentication failed账号或授权码错重新生成授权码确认用户名是完整邮箱550 Sender address rejected发件人域名不被服务商允许setFrom必须用服务商认可的域名554 Message rejected内容被判为垃圾邮件检查正文链接比例、是否缺AltBody发送成功但进垃圾箱认证记录问题配置 SPF、DKIM、DMARC见下节五、进垃圾箱怎么办三份 DNS 记录如果send()返回true但收件人始终在垃圾箱里找到邮件那问题不在 PHP而在你域名的邮件认证记录。这三份 TXT 记录必须配SPF声明「哪些主机有权以你的域名发信」例如在域名下添加一条 TXT内容形如vspf1 include:你的服务商给出的地址 -all。DKIM给邮件加上可验证的数字签名记录名是选择器._domainkey.你的域名。PHPMailer支持自行签名需要设置DKIM_domain、DKIM_selector、DKIM_private这几个属性后调用setDKIM()具体属性名与用法以PHPMailer官方文档为准另一个省事的做法是直接让邮件服务商代签。DMARC告诉收件方「认证失败时怎么办」记录名是_dmarc.你的域名内容形如vDMARC1; pnone; ruamailto:dmarc你的域名。建议先以pnone上线观察报告确认无误后再收紧策略。常见坑点1. 只设了端口没设加密方式或设反了❌$mail-Port 465;而SMTPSecure保持默认的STARTTLS—— 连接一直挂着直到超时报SMTP connect() failed。 ✅ 端口与加密方式配对设置不确定就先试 587 STARTTLS。2.openssl扩展没开❌ 配置全对仍然连不上日志里出现与 TLS 相关的报错。 ✅ 确认openssl扩展已启用用php -m检查没有它就无法建立加密连接。3. 用mail()拼中文主题❌ 自己写$subject 订单通知; mail($to, $subject, $body, From: ab.com);—— 中文主题按 8 位字节原样塞进 header各客户端解码方式不一结果就是乱码。 ✅ 使用PHPMailer并设置CharSet UTF-8如果确实要用mail()主题必须做 MIME 编码后再写入。4. 在循环里逐封新建 PHPMailer反复建连❌ 一次发 500 封营销邮件每封都new PHPMailer(true)并重新SMTP认证耗时极长还容易被服务商限流。 ✅ 复用同一个实例配合SMTPKeepAlive true在循环里只clearAllRecipients()或者干脆用服务商提供的批量接口。5. 发件人地址与 SMTP 账号不同域❌ 用noreplygmail.com作为setFrom却通过自己域名的 SMTP 服务发信 —— SPF 与 DKIM 对不上几乎必进垃圾箱。 ✅ 发件域名与发信域名保持一致并且该域名已配好 SPF/DKIM。6. 用户输入直接拼进 HTML 正文❌$mail-Body $htmlTemplate . $_POST[name];—— 用户提交的昵称里只要带一个尖括号邮件结构就被破坏甚至被反垃圾系统判定为钓鱼。 ✅ 所有插值用htmlspecialchars($v, ENT_QUOTES, UTF-8)转义后再拼接。7. 生产环境打开SMTPDebug且不做重定向❌$mail-SMTPDebug 2;直接上线 —— 调试信息默认echo到响应体页面会出现一堆协议文本还可能泄漏主机名与账号信息。 ✅ 只在排查时打开并用Debugoutput把输出重定向到日志。8. 授权码硬编码在代码里❌$mail-Password abcd1234;提交进 Git 仓库。 ✅ 走环境变量或配置中心读取并保证配置文件不进版本库。总结环节关键点典型故障选型用PHPMailer或Symfony Mailermail()依赖本机 MTA容器里通常没有连接主机 端口 加密方式三者配对465 配STARTTLS导致超时编码CharSet UTF-8中文主题变乱码内容HTML 正文 AltBody纯文本只发 HTML反垃圾评分变差安全插值转义、密码走环境变量正文结构被破坏、凭据泄漏送达率SPF DKIM DMARCsend()成功却在垃圾箱配置 SMTP 的难点不在代码而在「端口与加密配对、发件域名与账号同源、域名认证记录齐全」这三件事。把这三件事做对剩下的就只剩内容本身的合规性了——而任何技术手段都救不了一封内容被人举报的邮件。 
长河君 · 2026/10/3 9:28:34 · 阅读 1.2k PHP8.5怎么配置邮件发送功能SMTP
前言用 PHP 发邮件大概率会经历这三个阶段先写一行mail()觉得真简单然后发现邮件根本没发出去或者安静地躺在收件人的垃圾箱里最后翻遍资料才知道要用 SMTPSimple Mail Transfer Protocol连第三方邮件服务。mail()失败的原因其实很朴素它把邮件交给本机的邮件传输代理MTA例如 sendmail、postfix。而绝大多数 PHP 运行环境容器、云主机、共享空间里根本没有装 MTA也没有配置函数返回false或者干脆被disable_functions禁掉。就算本机有 MTA从家用宽带或云主机动态 IP 直发外网 25 端口也基本会被对方拒收。所以正确的做法是让 PHP 通过 SMTP 登录到专业的邮件服务商由它代发。本文用目前 PHP 生态里最常用的PHPMailer演示从安装、配置、发送 HTML 邮件与附件到排查「发出去了却进垃圾箱」的完整流程。示例基于PHP 8.5PHPMailer6.x 在 PHP 8.5 上可直接使用。一、先选路mail()、SMTP 客户端库怎么选方式依赖适合场景主要问题mail()本机 MTA有自建邮件服务器的内网系统容器里通常不存在 MTAPHPMailerComposer 包纯 PHP绝大多数业务邮件需要服务商账号Symfony MailerComposer 包已用 Symfony 全家桶的项目引入的组件较多邮件服务商 HTTP API只需curl只需发通知、要送达报告与 SMTP 语义不同需另写封装推荐PHPMailer成熟、文档全、纯 PHP 实现不需要任何扩展编译PHP 8.5 发布后只需composer update。composer require phpmailer/phpmailer二、SMTP 的三个关键参数连接任何 SMTP 服务要弄清楚的就三件事主机、端口、加密方式。端口与加密方式是绑定的配错了典型的症状是「卡住不返回最后超时」端口加密方式PHPMailer 常量说明587STARTTLS先明文握手再升级PHPMailer::ENCRYPTION_STARTTLS现代服务商的首选465隐式 TLS连上即加密PHPMailer::ENCRYPTION_SMTPS老式 SSL 端口仍被广泛支持25通常不加密空字符串多数云厂商已封禁出站 25 端口常见误配端口填 465 却设成STARTTLS客户端会一直等对方发明文握手问候而对方在等 TLS 握手双方互等直到超时。这是「SMTP connect() failed」里最隐蔽的一类。?php declare(strict_types1); use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\SMTP; use PHPMailer\PHPMailer\Exception; function makeMailer(string $host, int $port, string $user, string $pass): PHPMailer { $mail new PHPMailer(true); // true 出错时抛异常 $mail-isSMTP(); $mail-Host $host; $mail-Port $port; $mail-SMTPAuth true; $mail-Username $user; // 通常是完整邮箱地址 $mail-Password $pass; // 多数服务商要求「授权码」而不是登录密码 // 端口决定加密方式两者必须配对 $mail-SMTPSecure $port 465 ? PHPMailer::ENCRYPTION_SMTPS : PHPMailer::ENCRYPTION_STARTTLS; $mail-CharSet UTF-8; // 中文主题与正文必须显式设置 $mail-Timeout 10; // 单次连接超时秒避免请求被拖死 $mail-XMailer ; // 不暴露客户端版本信息 return $mail; }三个细节值得展开CharSet UTF-8不设置时 PHPMailer 默认使用iso-8859-1中文主题会变成乱码。用mail()手拼 header 时这个问题更常见因为编码方式要自己写。Password通常是授权码QQ 邮箱、163、企业邮箱等服务商都要求先在后台开启 SMTP 并生成独立的授权码直接用登录密码会认证失败。SMTPSecure与Port必须配对见上方表格。三、发一封完整的邮件HTML 正文 附件 抄送?php declare(strict_types1); use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\Exception; function sendOrderNotice(array $order): bool { $mail makeMailer( smtp.example.com, 587, noreplyexample.com, getenv(MAIL_AUTH_CODE) ?: ); try { // 发件人必须与 SMTP 账号属于同一域名否则 SPF/DKIM 对不上容易被判为垃圾邮件 $mail-setFrom(noreplyexample.com, 示例商城); $mail-addAddress($order[email], $order[name]); $mail-addReplyTo(supportexample.com, 客服); // 这里用纯文本正文演示HTML 正文的写法见本节末尾说明 $mail-isHTML(false); $mail-Subject 订单 . $order[id] . 已发货; $mail-Body implode(\n, [ 您好 . $order[name], 您的订单 . $order[id] . 已发货金额 . number_format((float) $order[amount], 2) . 元。, 如有疑问请直接回复本邮件。, ]); // 附件用「文件路径 显示名」不要用「文件内容 名字」的重载 $invoice __DIR__ . /invoices/ . $order[id] . .pdf; if (is_readable($invoice)) { $mail-addAttachment($invoice, invoice- . $order[id] . .pdf); } $mail-send(); return true; } catch (Exception $e) { // ErrorInfo 是字符串比异常消息更贴近底层原因 error_log(邮件发送失败 . $mail-ErrorInfo); return false; } }如果正文要带样式、按钮或表格把isHTML(true)打开并给Body赋 HTML 片段同时必须填写AltBody同样内容的纯文本版。这里有两个硬性要求所有插值必须转义。用htmlspecialchars($value, ENT_QUOTES, UTF-8)包住每一个用户数据用户昵称里带一个尖括号就能把整封邮件的版式打乱甚至被邮件网关判定为钓鱼内容。AltBody不能省。只有 HTML 正文的邮件在部分客户端显示不全反垃圾系统的评分也会更差。四、排查让 PHPMailer 把协议对话打出来发送不成功时最快的手段是打开调试输出。SMTPDebug会打印完整的 SMTP 对话过程EHLO、AUTH、MAIL FROM、DATA……一眼就能看出是卡在哪一步?php declare(strict_types1); use PHPMailer\PHPMailer\PHPMailer; use PHPMailer\PHPMailer\SMTP; $mail makeMailer(smtp.example.com, 587, noreplyexample.com, auth-code); // 2 客户端与服务端的往返对话3 再加上连接细节 $mail-SMTPDebug SMTP::DEBUG_SERVER; // 调试输出默认直接 echo 到响应体里正式代码中务必重定向到日志 $mail-Debugoutput static function (string $str, int $level): void { error_log([SMTP] . trim($str)); };读日志的对照表日志停在哪含义处理方向Connection refused端口不对或被防火墙拦换 587/465检查出站规则卡在CLIENT - SERVER: EHLO之后无响应加密方式与端口不匹配465 配SMTPS587 配STARTTLS535 Authentication failed账号或授权码错重新生成授权码确认用户名是完整邮箱550 Sender address rejected发件人域名不被服务商允许setFrom必须用服务商认可的域名554 Message rejected内容被判为垃圾邮件检查正文链接比例、是否缺AltBody发送成功但进垃圾箱认证记录问题配置 SPF、DKIM、DMARC见下节五、进垃圾箱怎么办三份 DNS 记录如果send()返回true但收件人始终在垃圾箱里找到邮件那问题不在 PHP而在你域名的邮件认证记录。这三份 TXT 记录必须配SPF声明「哪些主机有权以你的域名发信」例如在域名下添加一条 TXT内容形如vspf1 include:你的服务商给出的地址 -all。DKIM给邮件加上可验证的数字签名记录名是选择器._domainkey.你的域名。PHPMailer支持自行签名需要设置DKIM_domain、DKIM_selector、DKIM_private这几个属性后调用setDKIM()具体属性名与用法以PHPMailer官方文档为准另一个省事的做法是直接让邮件服务商代签。DMARC告诉收件方「认证失败时怎么办」记录名是_dmarc.你的域名内容形如vDMARC1; pnone; ruamailto:dmarc你的域名。建议先以pnone上线观察报告确认无误后再收紧策略。常见坑点1. 只设了端口没设加密方式或设反了❌$mail-Port 465;而SMTPSecure保持默认的STARTTLS—— 连接一直挂着直到超时报SMTP connect() failed。 ✅ 端口与加密方式配对设置不确定就先试 587 STARTTLS。2.openssl扩展没开❌ 配置全对仍然连不上日志里出现与 TLS 相关的报错。 ✅ 确认openssl扩展已启用用php -m检查没有它就无法建立加密连接。3. 用mail()拼中文主题❌ 自己写$subject 订单通知; mail($to, $subject, $body, From: ab.com);—— 中文主题按 8 位字节原样塞进 header各客户端解码方式不一结果就是乱码。 ✅ 使用PHPMailer并设置CharSet UTF-8如果确实要用mail()主题必须做 MIME 编码后再写入。4. 在循环里逐封新建 PHPMailer反复建连❌ 一次发 500 封营销邮件每封都new PHPMailer(true)并重新SMTP认证耗时极长还容易被服务商限流。 ✅ 复用同一个实例配合SMTPKeepAlive true在循环里只clearAllRecipients()或者干脆用服务商提供的批量接口。5. 发件人地址与 SMTP 账号不同域❌ 用noreplygmail.com作为setFrom却通过自己域名的 SMTP 服务发信 —— SPF 与 DKIM 对不上几乎必进垃圾箱。 ✅ 发件域名与发信域名保持一致并且该域名已配好 SPF/DKIM。6. 用户输入直接拼进 HTML 正文❌$mail-Body $htmlTemplate . $_POST[name];—— 用户提交的昵称里只要带一个尖括号邮件结构就被破坏甚至被反垃圾系统判定为钓鱼。 ✅ 所有插值用htmlspecialchars($v, ENT_QUOTES, UTF-8)转义后再拼接。7. 生产环境打开SMTPDebug且不做重定向❌$mail-SMTPDebug 2;直接上线 —— 调试信息默认echo到响应体页面会出现一堆协议文本还可能泄漏主机名与账号信息。 ✅ 只在排查时打开并用Debugoutput把输出重定向到日志。8. 授权码硬编码在代码里❌$mail-Password abcd1234;提交进 Git 仓库。 ✅ 走环境变量或配置中心读取并保证配置文件不进版本库。总结环节关键点典型故障选型用PHPMailer或Symfony Mailermail()依赖本机 MTA容器里通常没有连接主机 端口 加密方式三者配对465 配STARTTLS导致超时编码CharSet UTF-8中文主题变乱码内容HTML 正文 AltBody纯文本只发 HTML反垃圾评分变差安全插值转义、密码走环境变量正文结构被破坏、凭据泄漏送达率SPF DKIM DMARCsend()成功却在垃圾箱配置 SMTP 的难点不在代码而在「端口与加密配对、发件域名与账号同源、域名认证记录齐全」这三件事。把这三件事做对剩下的就只剩内容本身的合规性了——而任何技术手段都救不了一封内容被人举报的邮件。