使用FPDI合并PDF并自适应页面方向与尺寸-php教程-PHP中文网

使用FPDI合并PDF并自适应页面方向与尺寸

聖光之護

发布： 2025-11-07 12:58:32

原创

231人浏览过

使用FPDI合并PDF并自适应页面方向与尺寸

本教程详细介绍了如何使用php的fpdi库合并多个pdf文件，并解决因页面方向（如a4纵向与横向）不匹配导致内容截断的问题。核心方法在于导入源pdf页面时，动态获取其原始尺寸和方向，并据此创建新页面，确保合并后的文档完整保留所有内容的布局和显示效果。

在许多Web应用中，用户上传PDF文件并将其合并成一个统一文档的需求非常常见。然而，当这些源PDF文件包含不同的页面方向（如纵向和横向）或尺寸时，简单的合并操作可能会导致内容被裁剪或布局错乱。本文将详细阐述如何利用FPDI库解决这一挑战，确保合并后的PDF完美保留所有源页面的原始布局。

理解问题：页面方向不匹配

当使用FPDI（或FDPF）进行PDF合并时，默认情况下新创建的页面通常会采用预设的固定尺寸和方向（例如A4纵向）。如果源PDF中的某些页面是横向的，或者尺寸与目标页面不符，那么在导入并使用模板时，超出目标页面边界的内容就会被裁剪掉，导致信息丢失。

解决方案：动态获取页面尺寸与方向

解决此问题的关键在于，在导入源PDF的每一页时，不仅要导入其内容作为模板，更要获取该模板的原始尺寸和方向信息。然后，基于这些信息动态地为输出PDF添加新页面，确保新页面的尺寸和方向与源页面完全一致。

多面鹅

面向求职者的AI面试平台

查看详情

核心步骤：

初始化FPDI对象：首先，创建一个FPDI实例。
遍历待合并文件：对每个要合并的PDF文件进行处理。
获取源文件页面数量：使用setSourceFile()方法加载源PDF文件，并获取其总页数。
逐页导入并获取尺寸：
- 循环遍历源PDF的每一页。
- 使用importPage()方法导入当前页面，并获取其模板ID。
- 关键一步：使用getTemplateSize()方法，传入刚刚获取的模板ID，以获取该页面的原始尺寸和方向信息。这将返回一个包含width、height和orientation（'P' for Portrait, 'L' for Landscape）的数组。
添加新页面并应用模板：
- 根据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 \setasign\Fpdi\Fpdi(); // 初始化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()方法支持多种输出方式：
- 'I' (Inline): 直接在浏览器中显示PDF。
- 'D' (Download): 强制浏览器下载PDF文件。
- 'F' (File): 将PDF保存到服务器文件系统。
- 'S' (String): 将PDF作为字符串返回，不保存到文件或发送到浏览器。