
本文详解 PHP mail() 函数发送 HTML 邮件时变量无法解析的问题根源与解决方案,重点解决 HTML 字符串中 PHP 变量未被正确替换、导致收件人看到 $name 而非实际值的常见错误。
本文详解 php `mail()` 函数发送 html 邮件时变量无法解析的问题根源与解决方案,重点解决 html 字符串中 php 变量未被正确替换、导致收件人看到 `$name` 而非实际值的常见错误。
在 PHP 中通过 mail() 发送带格式的 HTML 邮件(如含表格的联系表单)时,一个高频陷阱是:将变量直接写在单引号包裹的字符串中——PHP 不会解析单引号字符串内的变量(如 '$name'),导致邮件正文显示为字面量 $name,而非用户提交的真实数据。
您代码中的关键问题正在于此:
$info = '<html>...<td>$name</td>...</html>'; // ❌ 单引号 + 变量名 → 原样输出
PHP 仅在双引号字符串或字符串拼接中解析变量。因此,必须改用以下任一方式:
将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML,替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度,HTML 能同时承载排版、表格、SVG 等。
✅ 正确做法一:使用双引号并转义引号(推荐用于简单场景)
$info = "<html>
<head><title>Contact Form Submission</title></head>
<body>
<table border='1' cellspacing='3' width='60%'>
<tr><td>Name:</td><td>$name</td></tr>
<tr><td>Email:</td><td>$email</td></tr>
<tr><td>Address:</td><td>$address</td></tr>
<tr><td>Phone:</td><td>$phone</td></tr>
<tr><td>Services:</td><td>$service</td></tr>
<tr><td>Subject:</td><td>$subject</td></tr>
<tr><td>Message:</td><td>$message</td></tr>
</table>
</body>
</html>";⚠️ 注意:HTML 属性值(如 border='1')需使用单引号,避免与外层双引号冲突;若必须用双引号属性,则内部需转义:border=\"1\"。
立即学习“PHP免费学习笔记(深入)”;
✅ 正确做法二:使用字符串拼接(更清晰、易维护)
$info = '<html>
<head><title>Contact Form Submission</title></head>
<body>
<table border="1" cellspacing="3" width="60%">
<tr><td>Name:</td><td>' . $name . '</td></tr>
<tr><td>Email:</td><td>' . $email . '</td></tr>
<tr><td>Address:</td><td>' . $address . '</td></tr>
<tr><td>Phone:</td><td>' . $phone . '</td></tr>
<tr><td>Services:</td><td>' . $service . '</td></tr>
<tr><td>Subject:</td><td>' . $subject . '</td></tr>
<tr><td>Message:</td><td>' . $message . '</td></tr>
</table>
</body>
</html>';? 安全与健壮性增强建议
-
HTML 实体安全输出:您已定义 contact_input() 进行 htmlspecialchars() 处理,这是正确的。但请确保在插入 HTML 表格前再次调用(或直接在拼接时使用):
<td>' . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . '</td>
-
设置 UTF-8 编码头(比 iso-8859-1 更通用):
$headers = "MIME-Version: 1.0\r\n"; $headers .= "Content-type: text/html; charset=UTF-8\r\n"; $headers .= "From: {$email}\r\n"; // 可选:添加发件人 -
验证 mail() 返回值,便于调试:
if (mail($mailto, $sub, $info, $headers)) { $contactsuccess = "Your message has been sent successfully!"; } else { $contactErr = "Failed to send email. Please try again."; }
? 完整修复后核心逻辑片段(整合优化)
if (empty($contactErr)) {
// 构建安全 HTML 邮件内容(双引号 + 变量插值)
$info = "<html>
<head><meta charset='UTF-8'><title>Contact Submission</title></head>
<body>
<h3>New Contact Form Submission</h3>
<table border='1' cellspacing='3' width='60%'>
<tr><td><strong>Name</strong></td><td>" . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . "</td></tr>
<tr><td><strong>Email</strong></td><td>" . htmlspecialchars($email, ENT_QUOTES, 'UTF-8') . "</td></tr>
<tr><td><strong>Address</strong></td><td>" . htmlspecialchars($address, ENT_QUOTES, 'UTF-8') . "</td></tr>
<tr><td><strong>Phone</strong></td><td>" . htmlspecialchars($phone, ENT_QUOTES, 'UTF-8') . "</td></tr>
<tr><td><strong>Service</strong></td><td>" . htmlspecialchars($service, ENT_QUOTES, 'UTF-8') . "</td></tr>
<tr><td><strong>Subject</strong></td><td>" . htmlspecialchars($subject, ENT_QUOTES, 'UTF-8') . "</td></tr>
<tr><td><strong>Message</strong></td><td>" . nl2br(htmlspecialchars($message, ENT_QUOTES, 'UTF-8')) . "</td></tr>
</table>
</body>
</html>";
$headers = "MIME-Version: 1.0\r\n";
$headers .= "Content-type: text/html; charset=UTF-8\r\n";
$headers .= "From: {$email}\r\n";
if (mail("your-email@example.com", "Get In Touch With Us", $info, $headers)) {
$contactsuccess = "Your message has been sent successfully! We will contact you shortly.";
// 重置表单字段
$name = $email = $address = $phone = $service = $subject = $message = "";
} else {
$contactErr = "Email delivery failed. Please check server configuration.";
}
}✅ 总结:永远不要在单引号字符串中期望变量解析;优先使用双引号插值或显式拼接,并始终对用户输入执行 htmlspecialchars() 处理,以兼顾功能正确性与 XSS 防护。


















