本教程详细介绍了如何使用php的fpdi库合并多个pdf文件，并解决因页面方向（如a4纵向与横向）不匹配导致内容截断的问题。核心方法在于导入源pdf页面时，动态获取其原始尺寸和方向，并据此创建新页面，确保合并后的文档完整保留所有内容的布局和显示效果。
在许多Web应用中，用户上传PDF文件并将其合并成一个统一文档的需求非常常见。然而，当这些源PDF文件包含不同的页面方向（如纵向和横向）或尺寸时，简单的合并操作可能会导致内容被裁剪或布局错乱。本文将详细阐述如何利用FPDI库解决这一挑战，确保合并后的PDF完美保留所有源页面的原始布局。
理解问题：页面方向不匹配
当使用FPDI（或FDPF）进行PDF合并时，默认情况下新创建的页面通常会采用预设的固定尺寸和方向（例如A4纵向）。如果源PDF中的某些页面是横向的，或者尺寸与目标页面不符，那么在导入并使用模板时，超出目标页面边界的内容就会被裁剪掉，导致信息丢失。
解决方案：动态获取页面尺寸与方向
解决此问题的关键在于，在导入源PDF的每一页时，不仅要导入其内容作为模板，更要获取该模板的原始尺寸和方向信息。然后，基于这些信息动态地为输出PDF添加新页面，确保新页面的尺寸和方向与源页面完全一致。
核心步骤：
- 初始化FPDI对象：首先，创建一个FPDI实例。
- 遍历待合并文件：对每个要合并的PDF文件进行处理。
- 获取源文件页面数量：使用setSourceFile()方法加载源PDF文件，并获取其总页数。
- 逐页导入并获取尺寸：
- 添加新页面并应用模板：
- 根据getTemplateSize()返回的orientation和完整的size数组，调用AddPage()方法向输出PDF添加一个新页面。这样可以确保新页面与源页面具有相同的方向和尺寸。
- 使用useTemplate()方法将导入的页面模板放置到新添加的页面上。
- 输出合并后的PDF：所有页面处理完毕后，使用Output()方法将最终的PDF保存到文件或发送到浏览器。
示例代码：
以下是实现上述逻辑的php代码示例：
<?php require_once('fpdf.php'); // 确保FDPF库已包含 require_once('fpdi.php'); // 确保FPDI库已包含 // 假设 $files 是一个包含所有待合并PDF文件路径的数组 // 例如: $files = ['path/to/portrait.pdf', 'path/to/landscape.pdf', 'path/to/another.pdf']; $pdf = new setasignFpdiFpdi(); // 初始化FPDI对象 // 遍历文件数组并合并 foreach ($files as $file) { // 检查文件是否存在且可读 if (!file_exists($file) || !is_readable($file)) { // 可以添加错误处理，例如跳过此文件或抛出异常 error_log("文件不存在或不可读: " . $file); continue; } try { // 获取源PDF的页面数量 $pageCount = $pdf->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()方法支持多种输出方式：
总结
通过上述方法，我们能够利用FPDI库的getTemplateSize()功能，在合并PDF时动态地适应每个源页面的尺寸和方向。这不仅解决了内容裁剪的问题，也确保了合并后的PDF文档能够忠实地呈现所有原始内容的布局和视觉效果，从而提供更加专业和用户友好的PDF处理解决方案。
以上就是使用FPDI合并PDF并自适应页面方向与尺寸的详细内容，更多请关注php中文网其它相关文章！