PHP mail()函数报错：SMTP需先执行STARTTLS命令问题求助

错误原因 #

530-5.7.0 Must issue a STARTTLS command first 错误表明你的SMTP服务器要求必须先启用STARTTLS加密才能发送邮件，但PHP原生mail()函数的默认配置未开启加密支持，无法满足服务器的安全要求。

方案一：修改PHP配置文件（依赖系统邮件服务） #

1. 编辑php.ini文件 #

找到你的PHP配置文件（通常在XAMPP/WAMP的php目录下），修改[mail function]段的配置（以Gmail为例）：

[mail function]
SMTP=smtp.gmail.com
smtp_port=587
sendmail_from=knowledgeweb3@gmail.com
; 若使用XAMPP的sendmail工具，添加以下配置
sendmail_path="\"C:\xampp\sendmail\sendmail.exe\" -t"

2. 配置sendmail.ini（XAMPP环境） #

如果使用XAMPP自带的sendmail，编辑sendmail.ini文件：

smtp_server=smtp.gmail.com
smtp_port=587
smtp_ssl=tls
auth_username=knowledgeweb3@gmail.com
auth_password=你的Gmail应用专用密码

注意：Gmail需开启两步验证后生成应用专用密码，不能直接使用账号登录密码。

方案二：改用PHPMailer库（推荐，更稳定） #

原生mail()函数功能有限，PHPMailer支持SMTP加密，兼容性更强。

1. 引入PHPMailer #

通过Composer安装或直接下载PHPMailer源码，将其放入项目目录后，在controllerUserData.php中引入相关类：

use PHPMailer\PHPMailer\PHPMailer;
use PHPMailer\PHPMailer\SMTP;
use PHPMailer\PHPMailer\Exception;

require 'PHPMailer/src/Exception.php';
require 'PHPMailer/src/PHPMailer.php';
require 'PHPMailer/src/SMTP.php';

2. 替换注册流程中的邮件发送代码 #

将原mail()函数部分替换为以下代码：

// 创建PHPMailer实例
$mail = new PHPMailer(true);

try {
    // SMTP配置
    $mail->isSMTP();
    $mail->Host = 'smtp.gmail.com';
    $mail->SMTPAuth = true;
    $mail->Username = 'knowledgeweb3@gmail.com'; // 发件人邮箱
    $mail->Password = '你的Gmail应用专用密码';
    $mail->SMTPSecure = PHPMailer::ENCRYPTION_STARTTLS;
    $mail->Port = 587;

    // 设置收件人
    $mail->setFrom('knowledgeweb3@gmail.com', '平台验证');
    $mail->addAddress($email);

    // 邮件内容
    $mail->isHTML(false);
    $mail->Subject = '邮箱验证码';
    $mail->Body = "您的验证码是$code";

    $mail->send();
    // 发送成功后的跳转逻辑
    $info = "我们已向您的邮箱$email发送了验证码";
    $_SESSION['info'] = $info;
    $_SESSION['email'] = $email;
    $_SESSION['password'] = $password;
    header('location: user-otp.php');
    exit();
} catch (Exception $e) {
    $errors['otp-error'] = "发送验证码失败！错误：{$mail->ErrorInfo}";
}

3. 同步修改忘记密码流程的邮件代码 #

按照同样的逻辑，替换忘记密码部分的mail()函数调用，确保所有邮件发送都使用PHPMailer。

注意事项 #

• 不同邮箱的SMTP配置不同：QQ邮箱SMTP服务器为smtp.qq.com，端口587，密码为邮箱授权码；网易邮箱为smtp.163.com，端口25或587。
• 若使用企业邮箱，需确认邮箱服务商提供的SMTP地址和加密要求。

内容的提问来源于stack exchange，提问作者max wil