本文深入解析 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 = "
    
    
        

            
Name:
$name
            
Email:
$email
            
Address:
$address
            
Phone:
$phone
            
Services:
$service
            
Subject:
$subject
            
Message:
$message
        
    ";

重要提示： 当使用双引号作为外层字符串的定界符时，为了避免引号嵌套冲突，建议将 HTML 标签内部的属性值改用单引号，例如 `border='1'`。如果必须使用双引号，请务必使用反斜杠进行转义，如 `border=\"1\"`。

方案二：采用字符串拼接方式（推荐，代码更清晰、维护性更佳）

对于内容较长或结构复杂的 HTML 邮件模板，更推荐使用字符串拼接（使用 `.` 操作符连接）的方式。这种方法虽然代码行数可能稍多，但结构一目了然，变量插入的位置极其明确，极大地提升了代码的可读性、可调试性和后期维护效率。

$info = '
    
    
        

            
Name:
' . $name . '
            
Email:
' . $email . '
            
Address:
' . $address . '
            
Phone:
' . $phone . '
            
Services:
' . $service . '
            
Subject:
' . $subject . '
            
Message:
' . $message . '
        
    ';

构建健壮邮件发送功能的关键细节

解决了变量解析问题只是第一步。要构建一个可用于生产环境的、健壮的邮件发送功能，还需要注意以下几个关键细节：

1. 必须进行 HTML 实体转义：原文中提到的 `contact_input()` 函数使用了 `htmlspecialchars()`，这是一个好习惯。但为了确保万无一失，尤其是在使用字符串拼接方案时，强烈建议在将变量插入 HTML 字符串时直接进行转义：

   ' . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . '

   这能有效防范跨站脚本（XSS）攻击。即使用户在表单中输入了包含 HTML 标签或 JavaScript 代码的内容，也会被安全地转换为纯文本实体显示，从而保障邮件内容的安全性。
2. 正确设置邮件头，特别是字符编码：使用 UTF-8 编码可以完美支持多语言字符（如中文、日文、韩文等），避免出现乱码问题。

   $headers = "MIME-Version: 1.0\r\n";
   $headers .= "Content-type: text/html; charset=UTF-8\r\n";
   $headers .= "From: {$email}\r\n"; // 可选：设置发件人地址，提升邮件可信度

3. 检查邮件发送状态并提供反馈：`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 = "
        
        
            
New Contact Form Submission
            

                
Name
" . htmlspecialchars($name, ENT_QUOTES, 'UTF-8') . "
                
Email
" . 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')) . "
            
        
    ";

    $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.";
    }
}

核心总结： 要彻底解决 PHP 发送 HTML 邮件时变量“失效”显示为变量名的问题，关键在于理解并正确应用字符串引号的解析规则。根据邮件模板的复杂度，灵活选择双引号变量插值或字符串拼接方案。同时，务必牢记安全准则：在将任何用户输入（如表单数据）嵌入 HTML 前，必须使用 `htmlspecialchars()` 函数进行转义处理。遵循这些原则，你的 PHP 邮件发送功能将既准确可靠，又安全无忧。