
本文详细介绍了如何使用 PHP 的 FPDI 库合并多个 PDF 文件,并解决因页面方向(纵向/横向)不一致导致内容截断的问题。通过动态检测源 PDF 页面的尺寸和方向,我们能够为每个导入的页面创建匹配的新页面,确保合并后的文档完整无损,从而实现更智能、更专业的 PDF 处理。
在 Web 应用中,经常需要处理用户上传的 PDF 文件,例如将多个 PDF 合并成一个。然而,一个常见的挑战是源 PDF 文件可能包含不同页面方向(如纵向 A4 和横向 A4)。如果简单地将所有页面导入到固定方向的新 PDF 中,横向页面内容可能会被裁剪,导致信息丢失。本教程将指导您如何利用 FPDI 库,在合并 PDF 时智能地适应每个源页面的方向和尺寸。
在开始之前,请确保您的 PHP 环境已安装并配置好以下库:
composer require setasign/fpdf composer require setasign/fpdi
解决页面方向不匹配问题的关键在于:在导入每个源 PDF 页面后,首先获取该页面的实际尺寸和方向,然后根据这些信息动态地为输出 PDF 添加一个新页面,最后将源页面内容放置到这个新页面上。这样,无论源页面是纵向还是横向,都能在新文档中得到正确的呈现。
立即学习“PHP免费学习笔记(深入)”;
以下是合并 PDF 并适应页面方向的详细实现步骤和代码示例:
首先,我们需要创建一个 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);将所有需要合并的 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;
// }
// ... 更多文件这是实现智能页面适应的核心部分。我们将遍历每个待合并的 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());
// 根据需要处理异常,例如跳过该文件或终止进程
}
}最后,将生成的 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";
}
?>通过本教程介绍的方法,您可以使用 PHP 和 FPDI 库高效地合并多个 PDF 文件,并智能地适应每个源页面的方向和尺寸。这种动态适应性确保了合并后的文档内容完整无缺,无论原始 PDF 的布局如何。这对于需要处理用户上传各种格式 PDF 的 Web 应用程序来说,是一个非常实用的解决方案。
以上就是PHP 使用 FPDI 合并 PDF 文件并智能适应页面方向的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号