本教程详细介绍了如何使用php的fpdi库合并多个pdf文件，并解决因源文件页面方向或尺寸不一致导致的显示问题。核心方法在于动态获取每个源pdf页面的尺寸和方向信息，然后在生成新pdf时，为每个导入的页面创建与其原始属性完全匹配的新页面，确保内容完整显示，避免裁剪。
在处理用户上传的PDF文件并将其合并成一个新文档时，开发者经常会遇到一个挑战：如何确保不同页面方向（如纵向A4与横向A4）或不同尺寸的PDF内容都能正确显示，而不会被裁剪或变形。传统的PDF合并方法，如果仅简单地将所有页面添加到固定尺寸（如A4纵向）的新文档中，会导致横向页面内容被截断。本教程将深入探讨如何利用FPDF的扩展库FPDI，实现智能化的PDF合并，自动适配源文件的页面特性。
理解问题：固定页面尺寸的局限性
在没有动态页面尺寸识别功能的情况下，通常的PDF合并流程是这样的：
// ... 文件路径收集 ...
// $files 包含所有待合并的PDF路径
$pdf = new \setasign\Fpdi\Fpdi();
foreach ($files as $file) {
$pageCount = $pdf->setSourceFile($file);
for ($i = 0; $i < $pageCount; $i++) {
$tpl = $pdf->importPage($i + 1, '/MediaBox');
$pdf->addPage(); // 默认添加固定尺寸和方向的页面
$pdf->useTemplate($tpl);
}
}
$pdf->Output('F', $upload_folder . '/' . $pdf_name);上述代码中，$pdf->addPage(); 默认会根据FPDF对象的初始设置（通常是A4纵向）添加新页面。这意味着，如果源PDF中包含横向页面，其内容在被导入到纵向页面时，超出的部分将被裁剪。
解决方案：动态获取并应用页面尺寸
FPDI库提供了强大的功能，允许我们不仅导入页面内容，还能获取这些页面的原始尺寸和方向信息。关键在于使用getTemplateSize()方法来获取导入页面的详细尺寸数据，然后将这些数据传递给AddPage()方法，从而为每个导入的页面创建与其原始属性完全匹配的新页面。
以下是实现这一功能的优化代码：
setSourceFile($file);
// 遍历源文件的每一页
for ($pageNo = 1; $pageNo <= $pageCount; $pageNo++) {
// 导入当前页作为模板
$templateId = $pdf->importPage($pageNo);
// 获取导入页面的尺寸信息（包括宽度、高度和方向）
$size = $pdf->getTemplateSize($templateId);
// 根据导入页面的尺寸和方向添加新页面
// $size['orientation'] 可能是 'P' (纵向) 或 'L' (横向)
// $size 数组包含 'width' 和 'height'
$pdf->AddPage($size['orientation'], [$size['width'], $size['height']]);
// 在新添加的页面上使用导入的模板
$pdf->useTemplate($templateId);
// 可选：在页面上添加一些文本，用于演示
$pdf->SetFont('Helvetica', '', 10);
$pdf->SetXY(5, 5);
$pdf->Write(8, '此页来自文件: ' . basename($file) . '，原始尺寸已适配。');
}
}
// 输出合并后的PDF到浏览器或保存到文件
// 'I' 表示在浏览器中打开，'D' 表示下载，'F' 表示保存到文件
$outputFileName = 'merged_document_dynamic.pdf';
$pdf->Output($outputFileName, 'I');
echo "PDF文件已成功生成并输出: " . $outputFileName;
?>代码详解
- require_once('fpdf.php'); require_once('fpdi.php');: 确保FPDF和FPDI库已正确加载。FPDI是FPDF的扩展，用于处理现有PDF文件。
- $pdf = new \setasign\Fpdi\Fpdi();: 创建FPDI实例。
- $pageCount = $pdf->setSourceFile($file);: 设置当前的源PDF文件，并获取该文件的总页数。这是FPDI开始读取PDF内容的第一步。
- $templateId = $pdf->importPage($pageNo);: 将源PDF中的指定页（$pageNo）导入为一个可用的模板。$templateId是一个内部标识符，用于后续引用此模板。
-
$size = $pdf->getTemplateSize($templateId);: 这是核心步骤。此方法返回一个关联数组，其中包含导入页面的详细尺寸信息，例如：
- ['width']: 页面的宽度。
- ['height']: 页面的高度。
- ['orientation']: 页面的方向，通常是 'P' (Portrait, 纵向) 或 'L' (Landscape, 横向)。
-
$pdf->AddPage($size['orientation'], [$size['width'], $size['height']]);: 利用getTemplateSize()获取到的信息，动态地添加一个新页面。
- 第一个参数 $size['orientation'] 确保新页面的方向与源页面一致。
- 第二个参数 [$size['width'], $size['height']] 确保新页面的尺寸与源页面完全匹配。
- 通过这种方式，无论源页面是A4、Letter还是其他自定义尺寸，也无论它是纵向还是横向，新创建的页面都将完美适配。
- $pdf->useTemplate($templateId);: 将之前导入的页面模板放置到当前新添加的页面上。
- $pdf->Output($outputFileName, 'I');: 输出最终合并的PDF文件。'I' 参数表示将PDF直接发送到浏览器，通常用于预览。其他常用模式包括 'D' (下载)、'F' (保存到文件)。
注意事项与最佳实践
- FPDF与FPDI的安装: 确保你的PHP环境中正确安装并引入了FPDF和FPDI库。通常可以通过Composer进行安装。
- 错误处理: 在实际生产环境中，应对文件不存在、PDF文件损坏等情况进行错误处理。例如，使用 try-catch 块来捕获setSourceFile()可能抛出的异常。
- 内存消耗: 合并大量或包含复杂图形的PDF文件可能会消耗大量内存。对于大型操作，考虑优化内存使用或分批处理。
- FPDI版本: 确保使用的FPDI版本与你的PHP版本兼容。
- 页面边界: getTemplateSize()通常返回MediaBox（媒体框）的尺寸。如果需要更精细的控制（如CropBox、BleedBox），FPDI也提供了相应的功能，但对于大多数合并场景，MediaBox已足够。
- 字体与样式: 在合并过程中，如果需要在导入的页面上添加新的文本或图形，请注意FPDF的坐标系统和字体设置。
总结
通过利用FPDI的getTemplateSize()方法，我们可以轻松实现智能化的PDF合并功能，确保无论源PDF文件的页面方向或尺寸如何，都能在合并后的文档中得到完美的呈现。这种动态适配的策略极大地提升了PDF处理的灵活性和用户体验，是处理用户上传PDF并进行二次开发时的关键技术。遵循本教程的方法，你将能够构建出健壮且功能强大的PDF合并解决方案。
