大型 HTML 文件的 DomPDF 渲染导致 500 错误答案

【问题标题】：DomPDF render of large HTML file results in 500 error大型 HTML 文件的 DomPDF 渲染导致 500 错误
【发布时间】：2013-03-14 16:25:00
【问题描述】：

我使用的是最新版本的 DomPDF（0.6.0 beta 3）。

PHP 版本是 5.2.17。

很遗憾，我使用的是共享主机帐户，无法升级 PHP 和类似操作。我也无权访问 apache 错误日志，无论如何我认为这不会很有帮助。

我已将 PHP 的 memory_limit 设置为 2048M 并将 max_execution_time 设置为 999。虽然不知道有没有生效。我认为它们实际上并不重要，因为我觉得 DomPDF 没有超时或内存不足。 500 错误似乎在请求页面后仅 10 秒发生，当我尝试生成页面较少的 PDF 时，脚本需要更长的时间（12-15 秒）但成功结束。

我有一个 72.3kb 的 HTML 文件，只有一个小的 HTML 表格。（事实上，删除带有表格的页面对解决问题没有任何帮助。）PDF 应该会产生大约 35 页。

经过大量挖掘，我发现错误发生在第 30 - 31 页，在page_frame_reflower.cls.php 函数内的以下代码行中：

  // Render the page
  $this->_frame->get_renderer()->render($child);

当echoing memory_get_usage 在每个循环（页面）上时，值保持相当一致，似乎低于可用内存的 5%。

在$this->_frame->get_renderer() 上使用get_class 我能够确定问题函数是Renderer::render()。

不幸的是，我没有简单的方法来继续使用我当前的方法进行调试。 Renderer::render() 方法不允许我将计数器变量添加到参数中，因为它需要与其父函数兼容。

任何人对我有任何帮助，你有没有看到我遗漏的任何东西 - 你能指出我修复这 500 个错误的正确方向吗？

编辑： 我已经从 HTML 文档中删除了所有内联 PHP 的使用，它似乎没有改变任何东西。

编辑 2： 文档太大，无法完全通过 Tidy，但最多 50000 字节没有错误。

编辑 3： PHP 错误日志记录已打开。我可以通过调用错误的方法名称和其他东西来产生错误。这些错误出现在屏幕上。事实上，即使我在问题方法之前导致无限循环，我也会将 PHP 最大执行时间达到错误打印到屏幕上。但是，问题区域显示 500 Internal Server Error 页面。

编辑 4： 我去掉了所有的 CSS，生成的 PDF 没有样式。现在我们正在取得进展。我会慢慢添加 CSS，然后我可以缩小问题代码的范围。谢谢，@Liv。

编辑 5： 我将 CSS 缩小到问题的萌芽：h1 规则。我在 h1 标签上使用了背景图片。因此，从我最初的问题来看，我所要做的就是从 h1 标签中删除背景图像，以使 PDF 正常工作。处理大量带有背景图像的元素对 DomPDF 来说是个问题吗？

编辑 6： 这是 HTML 文件：http://www.pickering-mcaloon.com/wp-content/uploads/2013/03/test2.html 我必须删除内容（不是我的）。我用 DomPDF 测试了这个版本的 HTML，得到了 500 服务器错误。我的标题图片是 25.1 kb。需要注意的是，每页的页脚也使用了背景图片，效果很好。在此 HTML 副本中，删除 1 个“章节”部分允许 DomPDF 完成 PDF 的生成。

编辑 7：当我第一次遇到问题时，我使用了 memory_get_usage 并且在循环顶部调用 Renderer::render() 时，每次它显示的用法略有不同，但是低于最大值的 6%，最大值设置为 2048M。我不认为这个问题是超时错误或内存错误，因为我可以在调用 render 之前产生这些类型的错误并将 PHP 错误打印到屏幕上。此外，运行大约 10 秒后会出现 500 错误 - 当 PDF 工作时，大约需要 15-20 秒。所以超时是不可能的。内存错误，但如果是这样，为什么不打印错误，因为它在调用render 之前内存溢出。

编辑 8： 我将用作 h1 标签的背景图像的图像从 PNG 转换为 JPG，从而将其大小从 25.1kb 减小到 2.6kb，并且正确生成了 PDF .这很可能是内存问题。 PHP 应该生成一个错误并显示给我，但它没有。

【问题讨论】：

错误是否每次都出现在同一行？对于这样的问题，它可以帮助查看 HTML。此外，PHP 会抛出 500 错误。如果你能得到错误，它会有所帮助。查看您的错误日志或修改您的设置，以便将错误发送到浏览器。
我实际上在使用 DomPDF 时遇到了类似的问题。 DomPDF 有很多复杂布局的问题。在我的特殊情况下，DomPDF 崩溃是因为我对表格应用了一些 CSS 规则（我相信问题是固定高度）。我的调试建议是尽可能从最基本的文档开始，逐步添加 CSS 规则和复杂性，直到发现问题所在。
@NicholasPickering 很高兴我的评论很有帮助。这个版本的 DomPDFsupposed 支持背景图像，但鉴于该项目在 GitHub 上有 168 个未解决的问题，如果您发现错误号 169，我不会感到惊讶。DomPDF 的 CSS 解析器非常很多“正在进行中的工作”，问题在于它没有放弃它认为无效的 CSS 规则（或者它只是无法理解），而是在没有太多有用的调试信息的情况下崩溃。
@NicholasPickering 我看不出背景图像会导致这种问题的任何原因。这可能是多种因素的组合。您是否有机会发布导致问题的 HTML？
@NicholasPickering JPG 是一种更简单的格式，因此它通常需要更少的处理（而且文件大小更小）。我不确定一般错误是怎么回事。如果您使用的是 Apache/FastCGI，您可能会检查该站点的 Apache 错误日志。 500 错误可能表示一个段错误，它会显示在那里。

标签： php dompdf

【解决方案1】：

我面临同样的问题并且仍在努力解决它。我正在使用 Dompdf 并尝试转换一个只有 33KB 的 HTML 页面，但我收到 500 个内部服务器错误。

我的 html 页面在 head 部分下有多个外部样式表，包括引导 css。但是当我删除引导 css 时， dompdf 工作正常。

删除此行可能会对您有所帮助 --> link type="text/css" rel="stylesheet" href="/bootstrap.css"

但我不知道应该怎么做才能将 Bootstrap.css 包含到 dompdf 中，以及为什么 bootstrap 样式会导致 dompdf 出错。

【讨论】：

这真的能解决他的问题吗？
在我发表评论后的 6 小时内，同时我正在解决同样的问题，我发现实际上是由于服务器上的许多问题而发生了 500 个内部服务器错误。所以我在我的 php 脚本的开头使用了这段代码。此代码将实际错误保存在错误日志文件中。 // 报告所有错误 error_reporting(E_ALL); ini_set('display_errors', true);在我的情况下，我收到非法字符串偏移 'hex' dompdf style.php 的错误
这是一个怎样的答案

【解决方案2】：

通常当内存限制低于所需内存时会发生此问题。

这些是增加的，例如： ini_set("memory_limit", "800M"); ini_set("max_execution_time", "800");

注意：在实例化类之前执行此操作，$dompdf = new DOMPDF();

这里设置了你需要的 memory_limit 或 max_execution_time。

【讨论】：

【解决方案3】：

我过去曾使用 DOMPDF 从 HTML 代码生成 PDF。我也面临同样的问题。经过多天的挣扎，我开始知道 dompdf 仅适用于像 3 到 4 页这样的小文档，这是粗略的数字。 Dompdf 非常适合基于 CSS 2 的样式，并且呈现接近现实。但它不支持大页面转换，如果你转换大页面 pdf 会花费太多时间并卡住或抛出 500 错误。如果您的 html 中有简单的渲染数据，我建议您使用 TCPDF。另一种选择是使用 wkhtmltopdf 扩展，它可以安装在 linux 服务器上并转换，只需告诉 url，它就会为您转换完全相同的 PDF。

这里有一些链接：

https://tcpdf.org/
https://wkhtmltopdf.org/
https://github.com/mikehaertl/phpwkhtmltopdf
https://stackoverflow.com/questions/5663814/how-do-i-get-wkhtmltopdf-to-execute-via-php

【讨论】：

【解决方案4】：

只有我的两分钱（不能在 OP 中发表评论，因为我的代表少于 50，抱歉）。经过几个小时的痛苦，检查了 Apache 日志（doh！），令我惊讶的是：

PHP Fatal error:  Uncaught exception 'Exception' with message 'The PHP GD extension 
is required, but is not installed.' in \\wwwroot\\app\\dompdf070\\lib\\Cpdf.php:4965

启用 GD 扩展解决了我的问题。

您可以在 PHP.INI 中取消注释该行

extension=php_gd2.dll

【讨论】：