PHP邮件发送功能完整实现指南-php教程-PHP中文网

PHP的mail()函数仅将邮件交予本地MTA，不保证发送成功；生产环境应改用PHPMailer等SMTP库，确保TLS认证、错误调试与合规签名。

php邮件发送功能完整实现指南

PHP 自带的 mail() 函数在大多数现代生产环境中无法直接发信——它依赖本地 sendmail 或 SMTP 代理，而云服务器、Docker 容器、共享主机普遍禁用或未配置该服务。真要稳定发邮件，必须走 SMTP 协议，并用可靠库封装连接、认证与错误处理。

为什么 `mail()` 在绝大多数情况下会静默失败

调用 mail() 返回 true 只代表“把信交给了本地 MTA”，不代表邮件已发出或送达。常见失效场景包括：

Linux 容器里根本没装 sendmail 或 postfix
腾讯云/阿里云默认屏蔽 25 端口，mail() 尝试直连 SMTP 时超时
收件方（如 QQ 邮箱）拒收无 SPF/DKIM 签名、无反向 DNS 的源 IP 发出的邮件
错误日志被 PHP 错误抑制（error_reporting(0)）或写入不可见位置

验证方式：临时加一行 error_log(print_r(error_get_last(), true), 3, '/tmp/php-mail.log'); 查看底层报错；但更推荐直接弃用 mail()。

用 `PHPMailer` 发带附件和 HTML 的邮件（Composer 方式）

不推荐手动拼接 MIME 头或用 cURL 模拟 SMTP——容易漏掉 TLS 协商、AUTH LOGIN 流程、换行符规范（CRLF）、编码转义等细节。PHPMailer 是经过大量邮件服务商实测的成熟封装。

安装与基础发送：

composer require phpmailer/phpmailer

最小可用示例（以 Gmail SMTP 为例）：

btpanel phpsite 宝塔面板PHP网站

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

下载

$mail = new PHPMailer\PHPMailer\PHPMailer();
$mail->isSMTP();
$mail->Host = 'smtp.gmail.com';
$mail->Port = 587;
$mail->SMTPAuth = true;
$mail->Username = 'your@gmail.com';
$mail->Password = 'your-app-password'; // 注意：不是登录密码，是 Google 账户里生成的“应用专用密码”
$mail->SMTPSecure = 'tls';

$mail->setFrom('your@gmail.com', '发件人名称');
$mail->addAddress('to@example.com');
$mail->Subject = '测试邮件';
$mail->isHTML(true);
$mail->Body = '<h2>这是一封 HTML 邮件</h2><p>支持 <strong>加粗</strong></p>';
$mail->AltBody = '这是纯文本备选内容';

if (!$mail->send()) {
    error_log('邮件发送失败: ' . $mail->ErrorInfo);
}

关键点：

SMTPSecure 值为 'tls' 时，Port 必须是 587；若用 'ssl'，则端口应为 465（部分服务商已弃用 SSLv3）
Gmail 必须开启两步验证并生成“应用专用密码”，直接填账户密码会报 SMTP Error: Authentication failed
国内企业邮箱（如网易企业邮、腾讯企业邮）通常要求使用域名邮箱（user@your-company.com），且需在控制台开启 SMTP 服务并获取授权码
附件用 $mail->addAttachment('/path/to/file.pdf')，路径必须是服务器上的绝对路径或可读流

发信失败时如何快速定位问题

别只看 $mail->send() 返回值。启用调试模式后，PHPMailer 会输出完整 SMTP 交互日志：

$mail->SMTPDebug = 2; // 1=客户端消息，2=客户端+服务端通信
$mail->Debugoutput = function($str) {
    error_log('[PHPMailer] ' . trim($str));
};

典型错误及应对：

SMTP connect() failed → 检查防火墙是否放行目标端口（telnet smtp.qq.com 587 测试连通性）
Authentication unsuccessful → 核对用户名是否含域名（user@domain.com）、密码是否为授权码、是否开启了 SMTP 服务
Message body empty → $mail->Body 或 $mail->AltBody 为空字符串，注意 isHTML(true) 后仍需提供纯文本备选
Could not instantiate mail function → Composer 自动加载失败，确认 vendor/autoload.php 已引入

真正麻烦的不是发不出去，而是发出去了却被当垃圾邮件——这取决于 SPF 记录、DMARC 策略、发信频率、内容关键词、IP 历史信誉。小项目用 Gmail 或腾讯企业邮起步没问题；用户量上来后，务必迁移到 SendGrid / Mailgun / Amazon SES 这类专业服务，并配好 DNS 记录。否则一封投诉，整个域名邮箱就进黑名单了。