在WordPress中使用dompdf导出PDF失败问题求助

问题根源 #

WordPress短代码嵌入在现有页面流程中，默认会在短代码执行前后输出主题的HTML内容（页面头部、导航、页脚等），这些额外内容会和dompdf生成的PDF二进制数据混合，导致PDF文件损坏、内容不完整，最终无法正常打开。

解决方案 #

修改短代码逻辑，确保dompdf生成PDF时完全独占输出流，具体实现如下：

add_shortcode('generate_pdf', function() {
    // 清空WordPress已输出的缓冲区内容（含空白字符、未闭合标签等）
    ob_clean();
    ob_end_flush();

    // 引入dompdf依赖
    require_once('/myurl/wp-content/plugins/myplugin/dompdf/autoload.inc.php');
    use Dompdf\Dompdf;

    $dompdf = new Dompdf();
    $dompdf->loadHtml('hello world');
    $dompdf->setPaper('A4', 'landscape');
    $dompdf->render();

    // 自定义PDF文件名，第二个参数设为0是在线预览，1则触发下载
    $filename = 'test.pdf';
    $dompdf->stream($filename, array('Attachment' => 0));

    // 终止后续所有输出，阻止WordPress继续输出页面其他内容
    exit;
});

关键说明 #

• ob_clean() + ob_end_flush()：清除WordPress在短代码执行前已经输出的缓冲区内容，避免这些内容混入PDF二进制数据。
• exit：必须在stream()之后调用，彻底终止WordPress后续的钩子、主题footer等输出流程，确保PDF是唯一的输出内容。
• 无需手动重复设置响应头：dompdf的stream()方法已自动配置了正确的Content-Type、Content-Disposition等响应头，手动添加易引发冲突。

额外排查点 #

• 确认dompdf的安装路径正确，autoload.inc.php可被正常引入。
• 检查短代码所在页面是否有其他插件/主题输出调试信息、错误提示等额外内容，这些也会破坏PDF文件结构。

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