Dompdf 1.0.2在WordPress环境生成PDF时CSS不生效问题求助

问题根因 #

现有代码存在三处核心配置错误：

• set_base_path参数配置错误：set_base_path() 接收参数为样式文件所在的目录路径，而非完整CSS文件路径，当前传入__DIR__ . '/style.css'会导致路径解析失败。
• link标签media属性不匹配：Dompdf默认使用print媒体类型渲染，代码中link标签指定media="screen"，会导致样式被自动忽略。
• 未开启本地文件加载权限：Dompdf默认禁用本地文件读取权限，未主动配置的情况下无法加载本地CSS文件。

修复步骤 #

1. 调整PHP运行代码 #

修正配置项，开启必要权限：

use Dompdf\Dompdf;
use Dompdf\Options;
$dirDompdf = ABSPATH . 'wp-content/plugins/dompdf';
require_once $dirDompdf . '/autoload.inc.php';

// 初始化Dompdf配置
$options = new Options();
$options->set('isRemoteEnabled', true); // 开启本地/远程文件加载权限
$options->set('isHtml5ParserEnabled', true); // 适配HTML5解析，避免DOMDocument加载异常
// 调试阶段可开启以下配置输出CSS解析日志，正式环境关闭
// $options->set('debugCss', true);

$invoiceHtmlFile = $pluginDir . '/invoice.html';
$invoiceHtmlDom = new DOMDocument();
// 屏蔽DOMDocument加载非标准HTML的警告
libxml_use_internal_errors(true);
$invoiceHtmlDom->loadHTMLFile($invoiceHtmlFile);
libxml_clear_errors();
$stringHtml = $invoiceHtmlDom->saveHTML();

$dompdf = new Dompdf($options);
// 修正base_path为样式文件所在目录，所有文件同目录的情况下直接传__DIR__即可
$dompdf->set_base_path(__DIR__);
// 可选：配置默认媒体类型为screen，匹配原有link标签的media属性
$dompdf->set_option('defaultMediaType', 'screen');
$dompdf->load_html($stringHtml);
$dompdf->render();
file_put_contents(__DIR__ . '/testing.pdf', $dompdf->output());

2. 调整HTML的link标签（可选，和上一步的defaultMediaType配置二选一即可） #

将link标签的media属性修改为all或print，适配Dompdf默认渲染规则：

<html>
    <head>
        <link rel="stylesheet" type="text/css" media="all" href="style.css" />
    </head>
    <body>
    <h1>Invoice</h1>
    </body>
</html>

备选兼容方案 #

如果路径解析始终存在问题，可直接将CSS内容嵌入HTML的<style>标签内，完全规避路径读取问题：

<html>
    <head>
        <style>
            h1 {
                text-align: center;
                font-size: 18pt;
            }
        </style>
    </head>
    <body>
    <h1>Invoice</h1>
    </body>
</html>

你提到的将HTML改为PHP文件动态引入CSS的方案也可行，本质是服务端将CSS内容拼接进HTML后再传给Dompdf渲染，和嵌入style标签的逻辑一致，可根据你的代码结构灵活选择。

其他注意事项 #

• 不需要额外安装依赖库，Dompdf 1.0.2本身已支持基础CSS渲染，只需确保style.css文件权限配置正确，WordPress环境下文件权限设置为644、所属目录权限为755即可正常读取。

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