PHP 使用 FPDI 合并 PDF 文件并智能适应页面方向

花韻仙語
发布: 2025-11-05 12:18:19
原创
890人浏览过

php 使用 fpdi 合并 pdf 文件并智能适应页面方向

本文详细介绍了如何使用 PHP 的 FPDI 库合并多个 PDF 文件,并解决因页面方向(纵向/横向)不一致导致内容截断的问题。通过动态检测源 PDF 页面的尺寸和方向,我们能够为每个导入的页面创建匹配的新页面,确保合并后的文档完整无损,从而实现更智能、更专业的 PDF 处理。

在 Web 应用中,经常需要处理用户上传的 PDF 文件,例如将多个 PDF 合并成一个。然而,一个常见的挑战是源 PDF 文件可能包含不同页面方向(如纵向 A4 和横向 A4)。如果简单地将所有页面导入到固定方向的新 PDF 中,横向页面内容可能会被裁剪,导致信息丢失。本教程将指导您如何利用 FPDI 库,在合并 PDF 时智能地适应每个源页面的方向和尺寸。

准备工作

在开始之前,请确保您的 PHP 环境已安装并配置好以下库:

  1. FPDF: FPDI 依赖于 FPDF,用于生成 PDF。
  2. FPDI: 用于导入现有 PDF 页面。您可以通过 Composer 安装:
    composer require setasign/fpdf
    composer require setasign/fpdi
    登录后复制

核心原理

解决页面方向不匹配问题的关键在于:在导入每个源 PDF 页面后,首先获取该页面的实际尺寸和方向,然后根据这些信息动态地为输出 PDF 添加一个新页面,最后将源页面内容放置到这个新页面上。这样,无论源页面是纵向还是横向,都能在新文档中得到正确的呈现。

立即学习PHP免费学习笔记(深入)”;

实现步骤

以下是合并 PDF 并适应页面方向的详细实现步骤和代码示例:

AppMall应用商店
AppMall应用商店

AI应用商店,提供即时交付、按需付费的人工智能应用服务

AppMall应用商店 56
查看详情 AppMall应用商店

1. 初始化 FPDI

首先,我们需要创建一个 FPDI 实例。FPDI 扩展了 FPDF,所以可以直接使用 FPDI 的类。

<?php

require_once('vendor/autoload.php'); // 假设您使用 Composer

// 创建 FPDI 实例
$pdf = new \setasign\Fpdi\Fpdi();

// 可选:设置默认字体和页边距等,如果需要自定义输出
// $pdf->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 <= $pageCount; $pageNo++) {
            // 导入当前页
            $templateId = $pdf->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');
登录后复制

完整代码示例

<?php

require_once('vendor/autoload.php'); // 假设您使用 Composer

// 创建 FPDI 实例
$pdf = new \setasign\Fpdi\Fpdi();

// 示例:待合并的 PDF 文件列表
// 请替换为您的实际文件路径
$filesToMerge = [
    'path/to/your/portrait_document.pdf',  // 示例:纵向 A4
    'path/to/your/landscape_report.pdf',   // 示例:横向 A4
    'path/to/another/mixed_pages.pdf',     // 示例:可能包含纵向和横向页面
];

// 确保输出目录存在
$outputDir = 'output_pdfs';
if (!is_dir($outputDir)) {
    mkdir($outputDir, 0777, true);
}
$outputFilePath = $outputDir . '/merged_document_with_auto_orientation.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 <= $pageCount; $pageNo++) {
            // 导入当前页
            $templateId = $pdf->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中文网其它相关文章!

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号