本教程详细阐述了如何在 php 中利用 fpdi 库合并多个 pdf 文件，并解决因源文件页面尺寸或方向不一致导致的裁剪问题。通过动态获取每个导入页面的尺寸和方向信息，fpdi 能够智能地为新页面设置正确的布局，确保所有内容完整无损地呈现，从而实现高效且兼容性强的 pdf 合并操作。
引言
在 Web应用开发 中，经常会遇到需要将多个用户上传的 PDF 文件合并成一个统一文档的需求。然而，不同来源的 PDF 文件可能具有不同的页面尺寸（如 A4、Letter）和方向（纵向、横向）。如果简单地将所有页面导入到一个固定尺寸和方向的输出 PDF 中，就可能导致内容被裁剪或布局错乱。本文将详细介绍如何使用 php 的 FPDI 库（一个基于 FPDF 的 PDF 解析器和模板引擎）来智能地合并 PDF，确保每个导入的页面都能正确适配其原始的尺寸和方向。
核心问题：页面尺寸与方向不匹配
当尝试合并 PDF 时，常见的挑战在于输出 PDF 的页面设置与源 PDF 的页面不一致。例如，如果输出 PDF 被设置为 A4 纵向，而源 PDF 中包含 A4 横向的页面，那么横向页面的内容在纵向页面上就会被裁剪。为了避免这种情况，我们需要一种机制来检测每个源 PDF 页面的实际尺寸和方向，并据此动态调整输出 PDF 中对应页面的设置。
解决方案概述：FPDI 的页面模板检测
FPDI 库提供了一个强大的功能，允许我们导入现有 PDF 的页面作为模板。更重要的是，它还提供了 getTemplateSize()方法，可以获取这些导入模板的尺寸和方向信息。利用这些信息，我们可以在向输出 PDF 添加新页面时，动态地设置页面的尺寸和方向，从而完美地适配源页面的布局。
环境准备
在开始之前，请确保您的 PHP 环境中已安装 FPDF 和 FPDI 库。您可以通过 composer 进行安装：
立即学习“PHP 免费学习笔记（深入）”；
composer require setasign/fpdf composer require setasign/fpdi实现步骤
合并 PDF 并适配页面尺寸与方向的详细步骤如下：
- 实例化 FPDI对象： 创建一个 FPDI 的实例。
- 构建文件列表： 收集所有需要合并的 PDF 文件路径。
- 遍历每个文件： 逐个处理文件列表中的 PDF。
- 获取页面总数： 对于每个文件，使用 setSourceFile()方法加载它，并获取其包含的页面总数。
- 遍历每个页面： 循环 处理当前文件的每一个页面。
- 导入页面模板： 使用 importPage()方法将源 PDF 的当前页面导入为一个模板。
- 获取模板尺寸： 利用 getTemplateSize()方法获取刚刚导入的页面模板的尺寸和方向信息。
- 添加新页面并适配： 使用 AddPage()方法向输出 PDF 添加一个新页面，并传入从 getTemplateSize()获取到的尺寸和方向参数。
- 使用模板： 将导入的页面模板内容放置到新添加的页面上，完成页面内容的复制。
- 输出合并后的 PDF： 将最终生成的 PDF 保存到文件或直接输出到 浏览器。
示例代码
以下是实现上述逻辑的 PHP 代码示例：
<?php require_once('vendor/autoload.php'); // 根据您的 Composer 配置调整路径 use setasignFpdiFpdi; // 假设 $files 数组包含了所有待合并的 PDF 文件路径 // 例如：$files = ['path/to/portrait_doc.pdf', // 纵向 PDF 'path/to/landscape_doc.pdf', // 横向 PDF 'path/to/another_doc.pdf' // 可能是不同尺寸的 PDF]; // 实例化 FPDI 对象 $pdf = new Fpdi(); // 遍历所有待合并的 PDF 文件 foreach ($files as $file) {// 检查文件是否存在且是 PDF if (!file_exists($file) || pathinfo($file, PATHINFO_EXTENSION) !== 'pdf') {echo " 跳过无效文件： " . $file . "n"; continue;} // 设置源文件，并获取其页面总数 $pageCount = $pdf->setSourceFile($file); // 遍历当前文件的所有页面 for ($pageNo = 1; $pageNo <= $pageCount; $pageNo++) {// 导入源 PDF 的当前页面作为模板 $templateId = $pdf->importPage($pageNo); // 获取导入模板的尺寸和方向信息 // $size['orientation'] 会是 'P' (纵向） 或 'L' (横向） // $size['width'] 和 $size['height'] 包含页面的实际尺寸 $size = $pdf->getTemplateSize($templateId); // 根据导入页面的尺寸和方向，添加一个新页面到输出 PDF // $size['orientation'] 决定方向 // $size 数组作为第二个参数，确保页面尺寸与源页面一致 $pdf->AddPage($size['orientation'], $size); // 在新添加的页面上使用导入的模板内容 $pdf->useTemplate($templateId); // (可选） 可以在每个页面上添加额外的文本或水印 // $pdf->SetFont('Helvetica', '', 10); // $pdf->SetXY(5, 5); // $pdf->Write(8,' 通过 FPDI 合并的页面 '); } } // 定义输出文件的路径 $outputFilePath ='path/to/merged_document.pdf'; // 输出合并后的 PDF 文件 //'F'表示保存到文件 //'I'表示直接在 浏览器 中显示 //'D'表示下载文件 $pdf->Output('F', $outputFilePath); echo "PDF 文件已成功合并并保存到： " . $outputFilePath . "n"; ?>关键函数解析
- $pdf = new Fpdi();
- $pageCount = $pdf->setSourceFile($file);
- 加载一个 PDF 文件作为源文件。它会解析 PDF 结构并返回该 PDF 的页面总数。
- $templateId = $pdf->importPage($pageNo);
- 从当前源文件中导入指定页码（$pageNo）的页面，并将其作为一个模板。返回一个模板 ID，用于后续操作。
- $size = $pdf->getTemplateSize($templateId);
- $pdf->AddPage($size[‘orientation’], $size);
- 向输出 PDF 添加一个新页面。
- 第一个参数 $size[‘orientation’] 用于指定页面的方向（纵向 ’P’ 或横向 ’L’）。
- 第二个参数 $size（整个数组）用于指定页面的具体尺寸。FPDF/FPDI 会根据这个数组中的 width 和 height 值来精确设置页面尺寸。
- $pdf->useTemplate($templateId);
- 将之前导入的模板内容绘制到当前活动的页面上。默认情况下，模板会放置在页面的左上角，并自动缩放到适应页面大小。
注意事项
- 内存消耗： 合并大量或包含复杂图形的 PDF 文件可能会消耗较多内存。对于非常大的文件，考虑分批处理或优化服务器配置。
- FPDF/FPDI 版本兼容性： 确保您使用的 FPDF 和 FPDI 版本是兼容的。通常，最新版本的 FPDI 会支持最新版本的 FPDF。
- 错误处理： 在生产环境中，应对文件不存在、文件损坏、非 PDF 文件等情况进行更健壮的错误处理。
- 字体和 编码 ： 如果在导入的页面上添加自定义文本，需要注意 FPDF 的字体和 编码 设置，以避免乱码问题。
- 性能优化： 如果需要合并成百上千个 PDF 文件，可以考虑优化文件读取和处理逻辑，例如使用流式处理或后台任务。
- 路径问题： 确保 require_once 和文件路径是正确的，特别是当脚本在不同环境下运行时。
总结
通过 FPDI 的 importPage()和 getTemplateSize()方法，我们可以有效地解决在 PHP 中合并 PDF 时遇到的页面尺寸和方向不一致的问题。这种动态适配的策略确保了合并后的 PDF 能够完美保留源文件的所有页面布局，极大地提高了 PDF 处理的灵活性和鲁棒性。遵循本文提供的步骤和示例代码，您可以轻松地构建一个功能强大的 PDF 合并解决方案。
