使用FPDI在PHP中合并PDF并智能适配页面尺寸与方向

本教程详细阐述了如何在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免费学习笔记（深入）”；

绘蛙

电商场景的AI创作平台，无需高薪聘请商拍和文案团队，使用绘蛙即可低成本、批量创作优质的商拍图、种草文案

179

查看详情

composer require setasign/fpdf
composer require setasign/fpdi

实现步骤

合并PDF并适配页面尺寸与方向的详细步骤如下：

1. 实例化FPDI对象： 创建一个FPDI的实例。
2. 构建文件列表： 收集所有需要合并的PDF文件路径。
3. 遍历每个文件： 逐个处理文件列表中的PDF。
4. 获取页面总数： 对于每个文件，使用setSourceFile()方法加载它，并获取其包含的页面总数。
5. 遍历每个页面： 循环处理当前文件的每一个页面。
6. 导入页面模板： 使用importPage()方法将源PDF的当前页面导入为一个模板。
7. 获取模板尺寸： 利用getTemplateSize()方法获取刚刚导入的页面模板的尺寸和方向信息。
8. 添加新页面并适配： 使用AddPage()方法向输出PDF添加一个新页面，并传入从getTemplateSize()获取到的尺寸和方向参数。
9. 使用模板： 将导入的页面模板内容放置到新添加的页面上，完成页面内容的复制。
10. 输出合并后的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合并解决方案。

以上就是使用FPDI在PHP中合并PDF并智能适配页面尺寸与方向的详细内容，更多请关注php中文网其它相关文章！