Dompdf批量生成PDF优化技巧与实战

本文将解决在使用 Dompdf 生成大量 PDF 文件时遇到的超时问题。通过分析常见原因，提出了从 Web 服务器环境迁移到命令行环境，并配合 set_time_limit 函数来规避超时限制的解决方案。同时，探讨了如何将 Web 页面的选择传递给命令行脚本，以实现批量 PDF 生成的需求，以实现批量 PDF 生成的需求。

当使用 Dompdf 在 Web 环境中生成大量 PDF 文件时，很容易遇到超时问题，这是因为 Web 服务器对脚本的执行时间有限制。例如，原问题中提到的生成 500+ PDF 文件，每个 PDF 文件包含多页内容，很容易触发 PHP 的 max_execution_time 限制以及 Web 服务器（如 Apache 或 IIS）的超时设置。解决这个问题，需要从根本上改变 PDF 生成的方式。

1. 切换到命令行环境 (CLI)

Web 服务器主要处理 HTTP 请求，并不适合长时间运行的任务。将 PDF 生成任务迁移到命令行环境，可以绕过 Web 服务器的超时限制，并获得更多的系统资源。

2. 使用 set_time_limit(0) 延长执行时间

在 CLI 脚本中，可以使用 set_time_limit(0) 函数来取消 PHP 的最大执行时间限制。这将允许脚本无限制地运行，直到完成所有 PDF 文件的生成。

   loadHtml($html);

       // (可选) 设置纸张大小和方向
       $dompdf->setPaper('A3', 'landscape');

       // 渲染 PDF
       $dompdf->render();

       // 保存 PDF 文件
       $output = $dompdf->output();
       $filename = 'item_' . $item . '.pdf';
       file_put_contents('pdf/' . $filename, $output);

       echo "Generated: " . $filename . "\n";
   }

   echo "PDF generation complete!\n";

   // 辅助函数 (需要根据实际情况实现)
   function getSaleData($item) { /* ... */ }
   function getPurchaseData($item) { /* ... */ }
   function getStockTransferData($item) { /* ... */ }
   function generateHtmlFromData($data) { /* ... */ }

   ?>

注意事项：

• 确保已安装 Dompdf 并通过 Composer 引入。
• 替换示例代码中的 getSaleData, getPurchaseData, getStockTransferData, generateHtmlFromData 函数为实际的数据库查询和 HTML 生成逻辑。
• 确保 pdf/ 目录存在并且 PHP 进程具有写入权限。

3. 将 Web 页面的选择传递给 CLI 脚本

如果需要在 Web 页面上选择需要生成 PDF 的项目，需要将这些选择传递给 CLI 脚本。 可以通过以下几种方式实现：

• 文件: Web 页面将选择的项目列表写入一个文件（例如，JSON 文件），CLI 脚本读取该文件。
• 数据库: Web 页面将选择的项目列表存储到数据库，CLI 脚本从数据库读取。
• 命令行参数: Web 页面通过 URL 或表单提交将选择的项目列表传递给 CLI 脚本（不推荐，因为 URL 长度有限制）。

例如，使用文件传递参数：

Web 页面 (PHP):

    /dev/null 2>&1 &'); // 在后台运行，不阻塞 Web 请求

   echo "PDF generation started in the background.\n";
   ?>

CLI 脚本 (generate_pdf.php):

注意事项：

• 确保 Web 服务器对 selected_items.json 文件具有写入权限，CLI 脚本具有读取权限。
• 使用 exec 函数在后台运行 CLI 脚本，避免阻塞 Web 请求。 > /dev/null 2>&1 & 将输出和错误重定向到空设备，并使脚本在后台运行。
• 考虑使用更安全的参数传递方式，例如数据库，以防止文件被篡改。

4. 其他优化技巧

• 内存优化： 如果 PDF 文件包含大量图片或复杂内容，可能会消耗大量内存。 尝试减少图片大小、简化 HTML 结构，或者使用 Dompdf 的流式渲染功能。
• 数据库优化： 确保数据库查询语句经过优化，避免查询大量不必要的数据。 可以使用索引、缓存等技术来提高查询效率。
• 错误处理： 在 CLI 脚本中添加完善的错误处理机制，记录错误日志，方便排查问题。

总结

通过将 PDF 生成任务迁移到命令行环境，并配合 set_time_limit(0) 函数，可以有效地解决使用 Dompdf 生成大量 PDF 文件时遇到的超时问题。 同时，需要考虑如何将 Web 页面的选择传递给 CLI 脚本，并进行适当的优化，以提高生成效率和稳定性。 这种方法适用于需要批量生成 PDF 文件，且对实时性要求不高的场景。