PHPMailer邮件发送问题：SMTP连接失败及内容变量未解析

一、Mailtrap环境下「SMTP Error: Could not connect to SMTP host」错误排查 #

• 核对SMTP核心配置：确认Host设为sandbox.smtp.mailtrap.io，端口选择2525、587（TLS）或465（SSL），SMTPAuth开启为true，用户名和密码严格匹配Mailtrap控制台提供的凭据，避免复制错误。
• 检查服务器网络限制：多数共享主机默认封禁25端口，优先尝试2525或587端口；同时确认服务器防火墙/安全组允许出站连接至Mailtrap的SMTP端口。
• 验证SSL/TLS配置：对应端口设置正确的SMTPSecure值（587用tls，465用ssl），并通过phpinfo()确认PHP的openssl扩展已启用，无加载异常。
• 排查DNS解析：在服务器终端执行ping sandbox.smtp.mailtrap.io或nslookup sandbox.smtp.mailtrap.io，确认域名能正常解析到IP，若解析失败需调整服务器DNS配置。

二、o2switch环境下邮件显示变量名而非实际数据的问题排查 #

• 修正字符串解析方式：PHP中单引号包裹的变量不会被解析，若主题/内容使用单引号（如$mail->Subject = '$title';），需改为双引号（$mail->Subject = "$title";），或用字符串连接符拼接（$mail->Subject = '留言标题：' . $title;）。
• 确认表单数据接收正确性：检查表单提交字段名与PHP接收变量的一致性，例如表单字段为<input name="title">，需用$title = htmlspecialchars($_POST['title']);（附带XSS防护）接收数据，确保变量已正确赋值。
• 核对PHPMailer内容赋值：检查Body/Subject属性的赋值逻辑，确保变量已被正确传入，例如$mail->Body = "用户留言内容：\n" . $comment;，避免直接写入未解析的变量字符串。
• 排查变量作用域：若PHPMailer发送逻辑封装在函数内，需确保表单接收的变量能被函数访问——可通过global $title, $comment;声明全局变量，或将变量作为函数参数传入。

内容的提问来源于stack exchange，提问作者Sofiane Abou Abderrahim