Debian11 Apache2+PHP8.1环境下Dompdf报DOMImplementation类不存在错误

你遇到的问题核心是Debian 11默认未安装PHP的DOM扩展，而XAMPP环境默认启用了该扩展，Dompdf依赖这个扩展完成HTML解析工作。

修复步骤： #

1. 安装PHP8.1的DOM扩展
   执行以下命令：

   sudo apt update
   sudo apt install php8.1-dom
   

2. 重启Apache2服务
   安装完成后必须重启服务让扩展生效：

   sudo systemctl restart apache2
   

3. 验证扩展是否启用

   • 可以创建一个phpinfo.php文件，内容为<?php phpinfo(); ?>，访问后搜索「dom」确认模块已加载
   • 或者在终端执行：

     php -m | grep dom
     

     输出「dom」则说明扩展已启用

额外检查项： #

• 如果你的Dompdf是通过Composer安装的，确认依赖版本兼容PHP8.1：Dompdf 2.0及以上版本支持PHP8.0+，可执行composer update dompdf/dompdf更新到兼容版本
• 检查代码中的use语句：全局类（如Exception、PDO）不需要通过use导入，你可以移除use Exception;和use PDO;这两行，避免不必要的命名空间冲突

测试代码 #

你可以用简化后的代码测试PDF生成是否正常：

class xyz
{
    use Dompdf\Dompdf;
    use Dompdf\Options;

    public function montaPDF($inform)
    {
        $options = new Options();
        $options->isFontSubsettingEnabled(false);
        $options->isRemoteEnabled(true);
        $pdf = new Dompdf($options);
        
        $html = '<!DOCTYPE html>
                <html lang="pt-br">
                <head>
                <meta charset="UTF-8">
                <meta name="viewport" content="width=device-width, initial-scale=1.0">
                </head><body>
                <p>测试PDF内容</p>
                </body></html>';                  
        
        $pdf->loadHtml($html);
        $pdf->render();
        $pdf->stream("dompdf_out.pdf", array("Attachment" => false));
    }
}

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