本文深入解析 PHP mail() 函数发送 HTML 格式邮件时，变量无法正常解析的核心原因与高效解决方案。重点解决 HTML 字符串中 PHP 变量未被正确替换、导致收件人看到 `$name` 等变量名而非实际表单数据的常见技术难题。
使用 PHP 内置的 `mail()` 函数发送一封格式美观的 HTML 邮件，例如将网站联系表单提交的数据整理成表格发送给管理员，是一个常见的开发需求。然而，许多开发者，甚至包括部分经验丰富的程序员，都曾遇到一个令人困惑的问题：邮件成功发送后，收件人打开的邮件内容中，姓名栏显示为 `$name`，邮箱栏显示为 `$email`——所有 PHP 变量都原封不动地以纯文本形式呈现，未能被替换为实际的值。
问题的根源究竟在哪里？答案其实非常明确，主要隐藏在构建邮件内容时对字符串引号类型的选择上。
问题的核心：单引号字符串的“字面解析”特性
PHP 在处理字符串时，单引号（`'`）和双引号（`"`）的行为有本质区别。双引号字符串支持变量插值（Variable Interpolation），会主动解析并替换字符串内的变量。而单引号字符串则采用“字面解析”方式，它会将其中所有内容，包括以 `$` 符号开头的变量名，都视为普通的文本字符，不会进行任何解析。
导致问题的典型错误代码通常如下所示：
$info = '...$name ...'; // ❌ 单引号包裹变量名 → 变量名被原样输出
这段代码执行后，`$info` 变量中存储的 `$name` 就仅仅是五个字符：“美元符号、n、a、m、e”。当这串内容作为邮件正文发送时，收件人自然只能看到这个未经解析的变量名。
两种可靠且高效的解决方案
理解了问题原理，解决方案便清晰明了。核心目标就是确保 PHP 引擎能够识别并处理嵌入在 HTML 字符串中的变量。以下两种方法均可有效解决问题，开发者可根据具体场景选择。
方案一：改用双引号定义字符串（适用于结构相对简单的邮件模板）
最直接的修复方法是将包裹 HTML 内容的单引号替换为双引号。这样，PHP 就会自动将 `$name`、`$email` 等变量替换为其对应的值。
$info = "
Contact Form Submission
| Name: | $name |
| Email: | |
| Address: | $address |
| Phone: | $phone |
| Services: | $service |
| Subject: | $subject |
| Message: | $message |
重要提示： 当使用双引号作为外层字符串的定界符时，为了避免引号嵌套冲突，建议将 HTML 标签内部的属性值改用单引号，例如 `border='1'`。如果必须使用双引号，请务必使用反斜杠进行转义，如 `border=\"1\"`。
方案二：采用字符串拼接方式（推荐，代码更清晰、维护性更佳）
对于内容较长或结构复杂的 HTML 邮件模板，更推荐使用字符串拼接（使用 `.` 操作符连接）的方式。这种方法虽然代码行数可能稍多，但结构一目了然，变量插入的位置极其明确，极大地提升了代码的可读性、可调试性和后期维护效率。
$info = '
Contact Form Submission
| Name: | ' . $name . ' |
| Email: | ' . $email . ' |
| Address: | ' . $address . ' |
| Phone: | ' . $phone . ' |
| Services: | ' . $service . ' |
| Subject: | ' . $subject . ' |
| Message: | ' . $message . ' |
构建健壮邮件发送功能的关键细节
解决了变量解析问题只是第一步。要构建一个可用于生产环境的、健壮的邮件发送功能，还需要注意以下几个关键细节：
- 必须进行 HTML 实体转义：原文中提到的 `contact_input()` 函数使用了 `htmlspecialchars()`，这是一个好习惯。但为了确保万无一失，尤其是在使用字符串拼接方案时，强烈建议在将变量插入 HTML 字符串时直接进行转义：
这能有效防范跨站脚本（XSS）攻击。即使用户在表单中输入了包含 HTML 标签或 JavaScript 代码的内容，也会被安全地转换为纯文本实体显示，从而保障邮件内容的安全性。' . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . ' - 正确设置邮件头，特别是字符编码：使用 UTF-8 编码可以完美支持多语言字符（如中文、日文、韩文等），避免出现乱码问题。
$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."; }
整合优化后的完整代码示例
将上述所有最佳实践结合起来，我们可以得到一个更安全、更健壮、功能更完善的 PHP 邮件发送代码示例：
if (empty($contactErr)) {
// 构建安全的 HTML 邮件内容（结合双引号插值与字符串拼接）
$info = "
Contact Submission
New Contact Form Submission
| Name | " . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . " |
| " . htmlspecialchars($email, ENT_QUOTES, 'UTF-8') . " | |
| Address | " . htmlspecialchars($address, ENT_QUOTES, 'UTF-8') . " |
| Phone | " . htmlspecialchars($phone, ENT_QUOTES, 'UTF-8') . " |
| Service | " . htmlspecialchars($service, ENT_QUOTES, 'UTF-8') . " |
| Subject | " . htmlspecialchars($subject, ENT_QUOTES, 'UTF-8') . " |
| Message | " . nl2br(htmlspecialchars($message, ENT_QUOTES, 'UTF-8')) . " |
核心总结： 要彻底解决 PHP 发送 HTML 邮件时变量“失效”显示为变量名的问题，关键在于理解并正确应用字符串引号的解析规则。根据邮件模板的复杂度，灵活选择双引号变量插值或字符串拼接方案。同时，务必牢记安全准则：在将任何用户输入（如表单数据）嵌入 HTML 前，必须使用 `htmlspecialchars()` 函数进行转义处理。遵循这些原则，你的 PHP 邮件发送功能将既准确可靠，又安全无忧。
