本教程详细介绍了如何使用php的fpdi库合并多个pdf文件，并解决因页面方向（如a4纵向与横向）不匹配导致内容截断的问题。核心方法在于导入源pdf页面时，动态获取其原始尺寸和方向，并据此创建新页面，确保合并后的文档完整保留所有内容的布局和显示效果。
在许多Web应用中，用户上传PDF文件并将其合并成一个统一文档的需求非常常见。然而，当这些源PDF文件包含不同的页面方向（如纵向和横向）或尺寸时，简单的合并操作可能会导致内容被裁剪或布局错乱。本文将详细阐述如何利用FPDI库解决这一挑战，确保合并后的PDF完美保留所有源页面的原始布局。
理解问题：页面方向不匹配
当使用FPDI（或FDPF）进行PDF合并时，默认情况下新创建的页面通常会采用预设的固定尺寸和方向（例如A4纵向）。如果源PDF中的某些页面是横向的，或者尺寸与目标页面不符，那么在导入并使用模板时，超出目标页面边界的内容就会被裁剪掉，导致信息丢失。
解决方案：动态获取页面尺寸与方向
解决此问题的关键在于，在导入源PDF的每一页时，不仅要导入其内容作为模板，更要获取该模板的原始尺寸和方向信息。然后，基于这些信息动态地为输出PDF添加新页面，确保新页面的尺寸和方向与源页面完全一致。
核心步骤：
- 初始化FPDI对象：首先，创建一个FPDI实例。
- 遍历待合并文件：对每个要合并的PDF文件进行处理。
- 获取源文件页面数量：使用setSourceFile()方法加载源PDF文件，并获取其总页数。
-
逐页导入并获取尺寸：
- 循环遍历源PDF的每一页。
- 使用importPage()方法导入当前页面，并获取其模板ID。
- 关键一步：使用getTemplateSize()方法，传入刚刚获取的模板ID，以获取该页面的原始尺寸和方向信息。这将返回一个包含width、height和orientation（'P' for Portrait, 'L' for Landscape）的数组。
-
添加新页面并应用模板：
- 根据getTemplateSize()返回的orientation和完整的size数组，调用AddPage()方法向输出PDF添加一个新页面。这样可以确保新页面与源页面具有相同的方向和尺寸。
- 使用useTemplate()方法将导入的页面模板放置到新添加的页面上。
- 输出合并后的PDF：所有页面处理完毕后，使用Output()方法将最终的PDF保存到文件或发送到浏览器。
示例代码：
以下是实现上述逻辑的PHP代码示例：
setSourceFile($file);
// 遍历源PDF的每一页
for ($pageNo = 1; $pageNo <= $pageCount; $pageNo++) {
// 导入当前页面作为模板
$templateId = $pdf->importPage($pageNo);
// 获取导入页面的尺寸和方向
// $size 数组将包含 'width', 'height', 'orientation' (P 或 L)
$size = $pdf->getTemplateSize($templateId);
// 根据源页面的尺寸和方向添加新页面
// 注意：AddPage() 的第二个参数可以直接接收 $size 数组，它会自动处理 width/height
$pdf->AddPage($size['orientation'], $size);
// 将导入的模板内容放置到新添加的页面上
$pdf->useTemplate($templateId);
// 可选：在这里添加额外的文本、图片、页眉页脚等
// $pdf->SetFont('Helvetica', '', 10);
// $pdf->SetXY(5, 5);
// $pdf->Write(8, '合并演示 - ' . basename($file) . ' - 第' . $pageNo . '页');
}
} catch (Exception $e) {
// 处理FPDI相关的错误，例如文件损坏等
error_log("处理文件时发生错误 " . $file . ": " . $e->getMessage());
}
}
// 定义输出文件的路径和名称
$outputFileName = 'merged_document_adaptive.pdf';
$outputFilePath = $upload_folder . '/' . $outputFileName; // 假设 $upload_folder 已定义
// 输出合并后的PDF到文件
// 'F' 参数表示将PDF保存到本地文件系统
$pdf->Output('F', $outputFilePath);
echo "PDF文件已成功合并并保存到: " . $outputFilePath;
?>注意事项与最佳实践：
-
依赖管理：确保您的PHP环境中已正确安装并引入了FPDF和FPDI库。通常，您可以通过Composer进行安装：
composer require setasign/fpdf composer require setasign/fpdi
- 错误处理：在实际应用中，务必加入健壮的错误处理机制。例如，检查源PDF文件是否存在、是否可读，以及FPDI在处理文件时可能抛出的异常（如文件损坏）。
- 性能考量：对于包含大量页面或文件的大型合并任务，处理时间可能会较长。考虑在后台任务中执行此操作，并向用户提供进度反馈。
- 内存使用：FPDI在处理大文件时可能会占用较多内存。确保PHP的memory_limit设置足够高。
- 自定义内容：在useTemplate()之后，您仍然可以在页面上添加自定义内容，如页眉、页脚、水印或额外的文本信息。
-
输出方式：$pdf->Output()方法支持多种输出方式：
- 'I' (Inline): 直接在浏览器中显示PDF。
- 'D' (Download): 强制浏览器下载PDF文件。
- 'F' (File): 将PDF保存到服务器文件系统。
- 'S' (String): 将PDF作为字符串返回，不保存到文件或发送到浏览器。
总结
通过上述方法，我们能够利用FPDI库的getTemplateSize()功能，在合并PDF时动态地适应每个源页面的尺寸和方向。这不仅解决了内容裁剪的问题，也确保了合并后的PDF文档能够忠实地呈现所有原始内容的布局和视觉效果，从而提供更加专业和用户友好的PDF处理解决方案。
