使用DomPDF v2.0.3生成PDF时PNG图片无法显示问题求助

以下是针对本地XAMPP环境下DomPDF图片不显示的具体排查和解决步骤：

• 检查文件系统权限
  XAMPP的Apache进程需要能读取图片文件：

  • Windows系统：右键图片文件→属性→安全，给Users组添加读取权限；
  • Linux/macOS：执行命令修改权限：

    chmod 644 /path/to/your/image.jpg
    chmod 755 /path/to/image/folder
    

• 使用本地文件系统绝对路径（而非URL）
  DomPDF对本地文件的路径解析优先于URL，避免用http://localhost/...形式，直接用真实文件路径：

  // 用realpath获取项目内图片的绝对路径
  $imageAbsPath = realpath($_SERVER['DOCUMENT_ROOT'] . '/assets/images/logo.png');
  // 嵌入HTML时直接使用该路径
  $html = '<img src="' . $imageAbsPath . '" width="150" height="80" />';
  

  注意Windows系统路径用正斜杠（/），不要用反斜杠（\），DomPDF对反斜杠解析存在兼容问题。

• 调整DomPDF核心配置
  确保相关配置项正确设置，尤其是根目录限制和远程资源开关：

  $dompdf = new Dompdf();
  $options = $dompdf->getOptions();
  // 开启远程资源支持（本地文件其实不需要，但避免冲突可开启）
  $options->set('isRemoteEnabled', true);
  // 设置chroot为项目根目录，限制DomPDF仅读取项目内文件，提升安全性同时避免路径解析错误
  $options->set('chroot', $_SERVER['DOCUMENT_ROOT']);
  // 开启调试模式，便于排查具体错误
  $options->set('debugPng', true);
  $dompdf->setOptions($options);
  

• 修正HTML图片标签写法

  • 不要使用相对路径简写（如./images/xxx.jpg），统一用基于项目根的路径或绝对路径；
  • 必须给图片标签添加明确的width和height属性，DomPDF对无尺寸的图片可能跳过渲染；
  • 避免使用CSS背景图，DomPDF对CSS背景图的支持有限，优先用<img>标签。

• 排查图片本身问题

  • 确认图片格式为DomPDF支持的类型（JPG、PNG、静态GIF，动态GIF仅显示第一帧）；
  • 用图片编辑器重新导出图片，排除文件损坏或编码异常（比如用Photoshop导出为标准JPG/PNG）。

• 捕获调试错误信息
  用try-catch捕获生成过程中的异常，直接查看具体错误：

  try {
      $dompdf->loadHtml($html);
      $dompdf->render();
      $dompdf->stream('result.pdf');
  } catch (\Exception $e) {
      die('生成PDF时出错：' . $e->getMessage());
  }
  

内容的提问来源于stack exchange，提问作者Carl Ret01