本文详细介绍了如何使用 PHP 的 FPDI 库合并多个 PDF 文件，并解决因页面方向（纵向/横向）不一致导致内容截断的问题。通过动态检测源 PDF 页面的尺寸和方向，我们能够为每个导入的页面创建匹配的新页面，确保合并后的文档完整无损，从而实现更智能、更专业的 PDF 处理。
在 Web 应用中，经常需要处理用户上传的 PDF 文件，例如将多个 PDF 合并成一个。然而，一个常见的挑战是源 PDF 文件可能包含不同页面方向（如纵向 A4 和横向 A4）。如果简单地将所有页面导入到固定方向的新 PDF 中，横向页面内容可能会被裁剪，导致信息丢失。本教程将指导您如何利用 FPDI 库，在合并 PDF 时智能地适应每个源页面的方向和尺寸。
准备工作
在开始之前，请确保您的 PHP 环境已安装并配置好以下库：
FPDF: FPDI 依赖于 FPDF，用于生成 PDF。FPDI: 用于导入现有 PDF 页面。您可以通过 Composer 安装：
composer require setasign/fpdfcomposer require setasign/fpdi
核心原理
解决页面方向不匹配问题的关键在于：在导入每个源 PDF 页面后，首先获取该页面的实际尺寸和方向，然后根据这些信息动态地为输出 PDF 添加一个新页面，最后将源页面内容放置到这个新页面上。这样，无论源页面是纵向还是横向，都能在新文档中得到正确的呈现。
立即学习“PHP免费学习笔记（深入）”；
实现步骤
以下是合并 PDF 并适应页面方向的详细实现步骤和代码示例：
1. 初始化 FPDI
首先，我们需要创建一个 FPDI 实例。FPDI 扩展了 FPDF，所以可以直接使用 FPDI 的类。
SetAutoPageBreak(true, 10);// $pdf->SetMargins(10, 10, 10);
2. 收集待合并的 PDF 文件
将所有需要合并的 PDF 文件路径存储在一个数组中。这些文件可以是用户上传的，也可以是服务器上预先存在的。
// 示例：待合并的 PDF 文件列表$filesToMerge = [ 'path/to/your/portrait_document.pdf', 'path/to/your/landscape_report.pdf', 'path/to/another/mixed_pages.pdf',];// 实际应用中，这可能来自表单上传或其他逻辑// $upload_folder = 'uploads';// $filesToMerge = [];// if (!empty($pdf_name)) {// $filesToMerge[] = $upload_folder . '/' . $pdf_name;// }// if (!empty($new_path) && pathinfo($new_path, PATHINFO_EXTENSION) == 'pdf') {// $filesToMerge[] = $new_path;// }// ... 更多文件
3. 遍历文件并导入页面
这是实现智能页面适应的核心部分。我们将遍历每个待合并的 PDF 文件，然后遍历该文件中的每个页面。
// 遍历所有待合并的文件foreach ($filesToMerge as $file) { // 检查文件是否存在且可读 if (!file_exists($file) || !is_readable($file)) { error_log("Warning: File not found or not readable: " . $file); continue; // 跳过当前文件，继续处理下一个 } try { // 设置源文件，获取总页数 $pageCount = $pdf->setSourceFile($file); // 遍历当前文件的每一页 for ($pageNo = 1; $pageNo importPage($pageNo); // 获取导入页面的尺寸和方向 // getTemplateSize() 返回一个包含 'width', 'height', 'orientation' 的关联数组 $size = $pdf->getTemplateSize($templateId); // 根据源页面的尺寸和方向，为输出 PDF 添加一个新页面 // $size['orientation'] 可以是 'P' (Portrait) 或 'L' (Landscape) // $size 数组可以直接作为第二个参数传递，FPDF 会从中提取 width 和 height $pdf->AddPage($size['orientation'], $size); // 使用导入的模板内容填充新添加的页面 $pdf->useTemplate($templateId); // 可选：在每个页面上添加自定义内容，例如页眉、页脚或水印 // $pdf->SetFont('Helvetica', '', 10); // $pdf->SetTextColor(0, 0, 0); // $pdf->SetXY(5, 5); // $pdf->Write(8, '合并文档示例 - 页面 ' . $pageNo); } } catch (Exception $e) { error_log("Error processing file " . $file . ": " . $e->getMessage()); // 根据需要处理异常，例如跳过该文件或终止进程 }}
4. 输出合并后的 PDF
最后，将生成的 PDF 输出到浏览器、保存为文件或作为字符串返回。
// 输出 PDF 到文件$outputFilePath = 'merged_document_with_auto_orientation.pdf';$pdf->Output('F', $outputFilePath);echo "PDF 合并完成并保存到: " . $outputFilePath;// 如果需要直接输出到浏览器，请使用 'I'// $pdf->Output('I', 'merged_document.pdf');// 如果需要作为字符串返回，请使用 'S'// $pdf->Output('S');
完整代码示例
setSourceFile($file); // 遍历当前文件的每一页 for ($pageNo = 1; $pageNo importPage($pageNo); // 获取导入页面的尺寸和方向 $size = $pdf->getTemplateSize($templateId); // 根据源页面的尺寸和方向，为输出 PDF 添加一个新页面 $pdf->AddPage($size['orientation'], $size); // 使用导入的模板内容填充新添加的页面 $pdf->useTemplate($templateId); // 可选：在每个页面上添加自定义内容 // $pdf->SetFont('Helvetica', '', 8); // $pdf->SetTextColor(100, 100, 100); // $pdf->SetXY(5, 5); // $pdf->Write(8, '合并示例 - ' . basename($file) . ' - 页 ' . $pageNo); } } catch (Exception $e) { error_log("Error processing file " . $file . ": " . $e->getMessage()); // 根据需要处理异常 }}// 输出 PDF 到文件try { $pdf->Output('F', $outputFilePath); echo "PDF 合并完成并保存到: " . $outputFilePath . "n";} catch (Exception $e) { error_log("Error outputting PDF: " . $e->getMessage()); echo "PDF 输出失败: " . $e->getMessage() . "n";}?>
注意事项与最佳实践
错误处理: 在实际应用中，务必加入健壮的错误处理机制。例如，检查文件是否存在、是否是有效的 PDF 文件，以及 FPDI 操作是否成功。内存管理: 合并大量或包含复杂图形的 PDF 文件可能会消耗大量内存。对于非常大的文件，考虑分批处理或优化服务器配置。FPDI 版本: 确保您使用的 FPDI 和 FPDF 版本兼容。不同版本之间可能存在 API 差异。PDF 复杂性: FPDI 主要处理 PDF 的视觉内容。如果源 PDF 包含交互式表单、JavaScript 或其他高级功能，这些特性在导入后可能无法完全保留。FPDI 旨在导入页面的视觉表示。性能: 对于大量页面，setSourceFile() 和 importPage() 操作可能耗时。如果性能是关键考量，可以考虑在后台任务中执行 PDF 合并。字体嵌入: 如果在合并后的 PDF 中添加自定义文本，请确保所使用的字体已嵌入或可用，以避免字体显示问题。
总结
通过本教程介绍的方法，您可以使用 PHP 和 FPDI 库高效地合并多个 PDF 文件，并智能地适应每个源页面的方向和尺寸。这种动态适应性确保了合并后的文档内容完整无缺，无论原始 PDF 的布局如何。这对于需要处理用户上传各种格式 PDF 的 Web 应用程序来说，是一个非常实用的解决方案。
以上就是PHP 使用 FPDI 合并 PDF 文件并智能适应页面方向的详细内容，更多请关注php中文网其它相关文章！
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。
如发现本站有涉嫌抄袭侵权/违法违规的内容， 请发送邮件至 chuangxiangniao@163.com 举报，一经查实，本站将立刻删除。
发布者：程序猿，转转请注明出处：https://www.chuangxiangniao.com/p/1330953.html
微信扫一扫 
支付宝扫一扫 
