Dompdf升级至v2.0.0后样式失效：setBasePath与setChroot配置问题

1. 正确设置chroot目录 #

Dompdf 2.0.0 强化了chroot安全机制，默认仅允许访问自身资源目录，自定义样式文件会被拦截。设置chroot需指向项目可访问的绝对路径，比如项目根目录或静态资源目录。

在你的MyPdfClass中初始化Dompdf时，通过配置类设置：

use Dompdf\Dompdf;
use Dompdf\Options;

class MyPdfClass {
    public function generatePdf() {
        $options = new Options();
        // 指向项目根目录（根据实际项目路径调整）
        $options->setChroot(__DIR__ . '/../'); 
        $dompdf = new Dompdf($options);
        
        // HTML中样式引用使用chroot下的相对路径
        $html = '<link rel="stylesheet" href="public/css/styles.css">';
        $dompdf->loadHtml($html);
        
        $dompdf->render();
        $dompdf->stream();
    }
}

注意：chroot必须为绝对路径，不能用相对路径；HTML里的资源路径要对应chroot目录下的相对位置。

2. 配置多个chroot目录 #

Dompdf 2.0支持添加多个chroot目录，无需覆盖默认的Dompdf资源目录。使用addChroot()方法追加额外目录即可，默认的Dompdf根目录会被自动保留。

示例：

$options = new Options();
// 设置主项目目录
$options->setChroot(__DIR__ . '/../');
// 添加额外的静态资源目录
$options->addChroot('/var/www/extra-static-resources');
// 如需单独指定Dompdf资源目录也可添加（默认已包含，非必须）
$options->addChroot(__DIR__ . '/../vendor/dompdf/dompdf');

$dompdf = new Dompdf($options);

这样既保留了Dompdf自身的资源访问权限，又能访问自定义目录，不会互相覆盖。

3. 是否需要使用setBasePath()？怎么用？ #

当HTML中的资源引用是相对路径，且与HTML内容的实际来源路径不一致时，setBasePath()可以指定资源解析的基准路径，和chroot配合使用更灵活。

比如HTML内容来自数据库、或样式路径相对于某个子目录时：

$html = '<link rel="stylesheet" href="styles.css">';
$dompdf->loadHtml($html);
// 设置基准路径为public/css目录，styles.css会自动指向该目录下的文件
$dompdf->setBasePath(__DIR__ . '/../public/css/');

注意：setBasePath()指定的路径必须在chroot目录范围内，否则Dompdf会拒绝访问。

额外排查提示 #

• 确认样式文件权限正确，Dompdf运行进程有读取权限
• 用$dompdf->getOptions()->getChroot()打印当前chroot目录，验证配置是否生效
• 尽量避免使用绝对URL加载资源，除非开启远程资源加载（$options->setIsRemoteEnabled(true)），推荐用chroot+相对路径的方式

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