解决使用 DomPDF 生成 PDF 遇到的行宽超出和图像失真问题

php

2024-03-20 07:11:37

用 DomPDF 生成完美 PDF：解决行宽超出和图像失真的问题

如果你正在使用 DomPDF 将网页转换为 PDF，但遇到了内容超出边距或图像纵横比失真的问题，那么这篇文章将为你提供一步一步的解决方案。

行宽超出的原因

内容超出 PDF 页面的右边缘可能是由于以下原因：

网页元素（如图片或表格）的宽度超过了页面的可用区域。
PDF 页边距设置不当，导致页面内容超出可用空间。

解决行宽超出的问题

解决超出边距的问题需要以下步骤：

调整网页元素的宽度： 检查所有超出页面的元素，并调整它们的宽度以适合页面。
设置适当的边距： 使用 DomPDF 的 setPaper 方法设置适当的边距值。例如，A4 纸张的典型边距设置如下：

$dompdf->setPaper('A4', 'portrait', [
    'margin_top' => '1cm',
    'margin_bottom' => '1cm',
    'margin_left' => '1cm',
    'margin_right' => '1cm'
]);

图像失真的原因

图像纵横比失真可能是由于以下原因：

图像的原始尺寸与 PDF 页面的尺寸不匹配。
DomPDF 的渲染设置导致图像变形。

解决图像失真的问题

解决图像失真问题需要以下步骤：

调整图像尺寸： 如果可能，调整原始图像尺寸以匹配 PDF 页面的尺寸。
设置图像渲染模式： 使用 DomPDF 的 setHtml5ParserOptions 方法将 defaultMediaType 设置为 screen。这将指示 DomPDF 以屏幕模式渲染图像，通常可以保留图像的纵横比。

$dompdf->setHtml5ParserOptions([
    'defaultMediaType' => 'screen'
]);

完整的解决方案代码

// Instantiate and use the dompdf class
$options = new Options();
// can fetch remote files
$options->set('isRemoteEnabled', true);
$dompdf = new Dompdf($options);

$dompdf->loadHtmlFile('https://devcoursetransfer.northcarolina.edu/bdp.html');

// Set appropriate page size and margins
$dompdf->setPaper('A4', 'portrait', [
    'margin_top' => '1cm',
    'margin_bottom' => '1cm',
    'margin_left' => '1cm',
    'margin_right' => '1cm'
]);

// Set image rendering mode to screen
$dompdf->setHtml5ParserOptions([
    'defaultMediaType' => 'screen'
]);

$dompdf->render();

ob_clean();
$dompdf->stream('Test.pdf');
exit;