PHP+DomPDF批量生成电商订单PDF过慢，寻求优化解决方案

你碰到的DomPDF批量渲染瓶颈其实非常常见——尤其是处理带Bootstrap这类复杂布局的多页文档时。既然已经排除了数据库查询和HTML构建的问题，咱们直接聚焦DomPDF本身和落地可行的优化策略：

1. 砍冗余！给PDF布局做“瘦身” #

Bootstrap的全量CSS对DomPDF来说是巨大的负担，它的响应式类、冗余选择器、非必要样式都会让渲染引擎做很多无用功。

• 专门为PDF生成写极简版专属CSS：只保留订单必需的样式（表格布局、字体、间距、页头页尾），完全抛弃Bootstrap中用不到的部分。
• 绝对不要在PDF的HTML里加JavaScript！DomPDF不支持JS，解析过程只会纯纯浪费时间。

2. 调整DomPDF核心配置参数 #

通过修改DomPDF的配置，能直接降低渲染开销：

// 在CodeIgniter中初始化DomPDF时调整配置
$dompdf = new Dompdf\Dompdf();
$options = $dompdf->getOptions();

// 开启字体子集化，大幅减小字体文件体积
$options->set('enable_font_subsetting', true);
// 关闭HTML5解析器（如果你的PDF HTML不需要HTML5特性）
$options->set('isHtml5ParserEnabled', false);
// 生产环境禁用debug模式，避免日志开销
$options->set('debug', false);
// 降低DPI（默认96足够，更高DPI会增加计算量）
$options->set('dpi', 96);

$dompdf->setOptions($options);

3. 分批次生成+PDF合并 #

一次性渲染数百页PDF会把DomPDF的内存和CPU拉满，换成“小批次生成+合并”的思路：

• 把订单分成20-30份一组，生成多个小型PDF文件；
• 用FPDF+FPDI组合合并这些小PDF（这俩库处理PDF合并的性能远优于DomPDF）：

require_once('fpdf.php');
require_once('fpdi.php');

$mergedPdf = new FPDI();
// 替换成你的小批次PDF临时文件路径
$batchPdfs = ['batch_1.pdf', 'batch_2.pdf', 'batch_3.pdf'];

foreach ($batchPdfs as $pdfFile) {
    $pageCount = $mergedPdf->setSourceFile($pdfFile);
    for ($page = 1; $page <= $pageCount; $page++) {
        $tplId = $mergedPdf->importPage($page);
        $mergedPdf->AddPage();
        $mergedPdf->useTemplate($tplId);
    }
}

// 输出合并后的PDF给用户下载
$mergedPdf->Output('all_orders.pdf', 'D');
// 记得删除临时的小批次PDF文件
foreach ($batchPdfs as $pdfFile) {
    unlink($pdfFile);
}

4. 升级依赖版本（长期收益） #

你当前用的PHP7.2和DomPDF0.82都属于旧版本，性能和稳定性都有提升空间：

• 升级PHP到7.4或8.x：这些版本在字符串处理、内存管理上有显著优化，能直接降低DomPDF的执行耗时；
• 升级DomPDF到最新稳定版（比如2.x）：官方修复了大量性能bug，渲染效率会有明显提升。注意提前测试HTML布局兼容性，新版本API有少量变化。

5. 服务器层面的辅助优化 #

• 给PHP-FPM加内存：修改php.ini的memory_limit为256M或512M，避免DomPDF渲染时因内存不足卡顿；
• 开启OPcache：大幅提升PHP脚本执行速度，尤其是重复调用的DomPDF代码，在php.ini中配置：

  opcache.enable=1
  opcache.enable_cli=1
  opcache.memory_consumption=128
  opcache.max_accelerated_files=10000
  

• 本地缓存静态资源：如果PDF里有商品图等远程资源，提前下载到本地再引用，避免DomPDF每次都发起网络请求。

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