Apache+PHPMailer环境下邮件模板PHP if语句未解析问题

核心问题在于模板渲染方式错误：你大概率是直接读取了order_confirmation.html.php的文件内容，没有让PHP解析器处理其中的if语句块；而三元表达式能正常工作，可能是因为它处于PHP变量替换的上下文里（比如嵌入在已解析的变量中），或者<?=短标签在配置中被正常识别，但块级的if语句必须通过PHP引擎执行才能生效。

错误的常见写法（你可能正在用） #

如果你的SystemMailer.php里是这样加载模板的，就会导致if语句无法解析：

// 错误：直接读取文件内容，PHP代码不会被执行
$htmlContent = file_get_contents('order_confirmation.html.php');
// 或者用str_replace替换变量后直接使用
$mail->Body = str_replace('{{order_total}}', $data['order_total'], $htmlContent);

正确的模板渲染方法 #

使用PHP输出缓冲机制，通过include让PHP解析模板中的所有代码，再捕获渲染后的内容：

修改SystemMailer.php中的模板加载逻辑 #

// 开启输出缓冲
ob_start();
// 将$data数组中的变量暴露给模板（可选，也可以直接在模板中用$data['key']）
extract($data, EXTR_SKIP); // EXTR_SKIP避免覆盖已存在的变量
// 加载并执行模板文件（用绝对路径避免路径问题）
include __DIR__ . '/path/to/order_confirmation.html.php';
// 获取渲染后的内容并关闭缓冲
$htmlContent = ob_get_clean();

// 传给PHPMailer
$mail->isHTML(true);
$mail->Body = $htmlContent;

模板文件（order_confirmation.html.php）的正确写法 #

确保if语句使用标准PHP语法：

<!DOCTYPE html>
<html>
<head>
  <title>订单确认</title>
</head>
<body>
  <h1>你的订单已确认</h1>
  <p>订单总额：<?= $data['order_total'] ?? '0.00' ?></p>
  
  <!-- 只有当order_shipping存在时才渲染这部分 -->
  <?php if (isset($data['order_shipping'])): ?>
  <div class="shipping-info">
    <p>运费：<?= $data['order_shipping'] ?></p>
  </div>
  <?php endif; ?>
</body>
</html>

关键注意事项 #

1. 绝对路径：使用__DIR__拼接模板路径，避免因当前工作目录变化导致找不到模板文件。
2. 变量安全：如果使用extract($data)，加上EXTR_SKIP参数防止变量覆盖；更安全的方式是直接在模板中使用$data['key']访问。
3. PHP配置：确保short_open_tag配置开启（PHP 7.2默认开启），保证<?=短标签正常解析。
4. 避免混合渲染：不要同时用file_get_contents读取模板和include执行，保持逻辑统一。

内容的提问来源于stack exchange，提问作者Kevin G