本教程详细阐述了如何在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 setasign\Fpdi\Fpdi;
// 假设 $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();
- 实例化FPDI类。FPDI继承自FPDF，因此可以使用FPDF的所有方法。
- $pageCount = $pdf->setSourceFile($file);
- 加载一个PDF文件作为源文件。它会解析PDF结构并返回该PDF的页面总数。
- $templateId = $pdf->importPage($pageNo);
- 从当前源文件中导入指定页码（$pageNo）的页面，并将其作为一个模板。返回一个模板ID，用于后续操作。
- $size = $pdf->getTemplateSize($templateId);
- 获取由importPage()方法返回的模板ID所对应的页面模板的尺寸和方向信息。
- 返回一个关联数组，通常包含 width (宽度), height (高度), orientation (方向，'P' 或 'L') 等键。
- $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合并解决方案。
