使用Dompdf生成的PDF损坏，$html变量定义存疑求排查

1. 检查$html变量的完整性与合法性 #

• 必须保证$html是完整的标准HTML结构，包含<html>、<head>、<body>标签，Dompdf对不完整的HTML解析极易出错。示例正确写法：

  $html = '<!DOCTYPE html>
  <html>
  <head>
      <meta charset="UTF-8">
      <title>PDF内容</title>
  </head>
  <body>
      <h1>'.htmlspecialchars($_POST['title'], ENT_QUOTES).'</h1>
      <p>'.htmlspecialchars($_POST['content'], ENT_QUOTES).'</p>
  </body>
  </html>';
  

• 先注释掉Dompdf相关代码，直接echo $html输出到浏览器，检查是否存在语法错误、乱码或未闭合标签——这是排查PDF损坏的核心步骤。

2. 输出PDF前的缓冲区与头信息处理 #

• 绝对禁止输出PDF前有任何多余内容（包括PHP标签外的空格、换行、echo调试语句），哪怕一个空格都会导致PDF文件损坏。
• 正确的缓冲区与头信息写法：

  // 清空所有残留缓冲区内容
  ob_clean();
  ob_start();
  
  // 初始化Dompdf并生成PDF
  $dompdf = new Dompdf();
  $dompdf->loadHtml($html);
  $dompdf->setPaper('A4', 'portrait');
  $dompdf->render();
  
  // 输出PDF的头信息
  header('Content-Type: application/pdf');
  header('Content-Disposition: inline; filename="result.pdf"');
  
  // 输出PDF并终止后续代码执行
  $dompdf->stream('result.pdf');
  exit;
  

• 注意：ob_clean()要优先于ob_start()执行，确保清除之前可能产生的缓存内容。

3. POST变量的接收与转义 #

• 接收POST变量时要做存在性检查，避免未定义变量破坏HTML结构：

  $post_id = isset($_POST['id']) ? intval($_POST['id']) : 0;
  

• 拼接HTML时必须对变量做转义处理，防止XSS攻击和HTML语法错误：

  $title = htmlspecialchars($_POST['title'], ENT_QUOTES, 'UTF-8');
  

4. Dompdf配置与依赖检查 #

• 确保使用Dompdf的最新稳定版本，旧版本可能存在HTML解析bug。
• 检查PHP环境是否满足依赖：启用mbstring、gd扩展，PHP版本符合对应Dompdf版本要求（一般>=7.1）。
• 若HTML中包含外部CSS、图片，必须使用绝对路径或相对于当前PHP文件的相对路径，Dompdf无法加载外部资源也会导致PDF损坏。

5. 最小化案例测试 #

如果以上排查都无问题，先运行最小化测试代码排除干扰：

<?php
require_once 'dompdf/autoload.inc.php';
use Dompdf\Dompdf;

// 固定测试HTML
$html = '<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
</head>
<body>
    <h1>测试PDF</h1>
    <p>这是一份测试内容</p>
</body>
</html>';

ob_clean();
ob_start();

$dompdf = new Dompdf();
$dompdf->loadHtml($html);
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();

header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="test.pdf"');
$dompdf->stream('test.pdf');
exit;

如果此代码能生成正常PDF，说明问题出在你的动态HTML拼接或POST变量处理上；若仍损坏，检查Dompdf的安装是否正确。

内容的提问来源于stack exchange，提问作者Mohammad Rohman