升级DomPDF至2.0.3后图片无法加载的技术求助

以下是针对DomPDF升级后图片不显示问题的常见排查方向和解决方法：

1. 配置Chroot路径限制 #

DomPDF 2.x对本地文件访问的限制更严格，通过设置chroot选项指定允许访问的根目录，能帮助正确解析相对路径：

$options = new Options();
$options->set('isRemoteEnabled', true);
$options->set('chroot', __DIR__); // 替换为你的项目根目录或图片所在上级目录

2. 替换为绝对路径 #

将HTML中的图片相对路径替换为服务器绝对路径，确保DomPDF能准确定位文件：
在你替换{HOUSE_TYPE_ICON}等变量时，生成完整路径：

// 示例：替换图片路径变量
$html = str_replace(
    '{HOUSE_TYPE_ICON}',
    realpath(__DIR__ . '/images/' . $houseTypeIconValue), // $houseTypeIconValue是AJAX获取的文件名
    $html
);
// 静态图片同理替换
$html = str_replace(
    'images/PDF/buildingInformation.png',
    realpath(__DIR__ . '/images/PDF/buildingInformation.png'),
    $html
);

3. 检查文件权限 #

确保Web服务器进程（如www-data、apache）拥有图片文件及所在目录的读取权限：

# 调整目录权限
chmod -R 755 /path/to/your/images/folder
# 调整文件权限
chmod 644 /path/to/your/images/*.png

4. 验证图片处理扩展支持 #

DomPDF依赖GD或Imagick扩展处理图片，确认GD扩展已安装并启用，且支持你使用的图片格式（PNG/JPG等）。可以通过phpinfo()查看GD的配置状态。

5. 开启调试模式排查具体错误 #

启用DomPDF的调试日志，查看图片加载失败的具体原因：

$options->set('debug', true);
$dompdf->render();
// 输出调试日志
print_r($dompdf->getDebugLog());

内容的提问来源于stack exchange，提问作者Columbian Toad