使用FPDI和FPDF在PHP中实现大型PDF页面分片打印教程

花韻仙語

发布时间：2025-07-17 14:52:01

763人浏览过

来源于php中文网

原创

使用fpdi和fpdf在php中实现大型pdf页面分片打印教程

本教程详细介绍了如何利用PHP的FPDI和FPDF库，将一个大型单页PDF文档（如缝纫图案）自动分割成多个标准尺寸（如Letter或A4）的页面，以便于打印和拼接。通过直接操作PDF内容，而非转换为图像，本方法效率更高，且能保持高质量输出。教程包含详细的代码示例和关键注意事项，帮助开发者实现高效的PDF页面分片功能。

在日常工作中，我们有时会遇到需要打印超大尺寸PDF文档（例如工程图纸、海报或缝纫图案）的情况。这些文档通常设计为单页，但实际打印时需要将其拆分成多张标准尺寸的纸张（如A4或Letter），再进行拼接。传统的解决方案可能包括使用ImageMagick将PDF转换为图像，然后裁剪并重新组合，但这不仅效率低下，还可能导致图像质量损失。本教程将介绍一种更为优雅和高效的方法，利用PHP的FPDF和FPDI库直接对PDF内容进行操作，实现高质量的页面分片。

核心原理：FPDI与FPDF的协同工作

FPDI（FPDF_TPL, FPDF_PARSER, FPDF_CORE）是一个基于FPDF的扩展，它允许我们导入现有的PDF页面作为模板，然后在新的PDF文档中进行操作。其核心思想是：

导入源PDF页面： 使用FPDI将大型PDF文档的指定页面导入为一个可复用的模板。
创建目标页面： 使用FPDF创建新的、标准尺寸的空白页面（例如Letter或A4）。
定位与裁剪： 将导入的源PDF模板放置到新创建的页面上。通过巧妙地设置模板的起始坐标为负值，我们可以“滑动”或“裁剪”源模板，使其在当前标准尺寸页面上只显示所需的分片区域。由于目标页面尺寸较小，超出其边界的内容将自动被“裁剪”掉，从而实现分片效果。

这种方法避免了图像转换的中间步骤，直接操作PDF矢量数据，因此能够保持原始文档的清晰度和质量。

环境准备

在开始之前，请确保您的PHP环境中已安装并配置好FPDF和FPDI库。您可以通过Composer进行安装：

立即学习“PHP免费学习笔记（深入）”；

TTSMaker

TTSMaker是一个免费的文本转语音工具，提供语音生成服务，支持多种语言。

下载

composer require setasign/fpdf
composer require setasign/fpdi

如果您的项目没有使用Composer，您可以手动下载库文件并将其包含在项目中。

实现步骤与代码示例

以下是一个详细的PHP代码示例，演示如何将一个24英寸高、96英寸宽的单页PDF分割成多个Letter尺寸（8.5英寸宽、11英寸高）的页面。

setSourceFile($sourcePdfPath);
        if ($pageCount < 1) {
            echo "错误：源PDF文件不包含任何页面。\n";
            return false;
        }
        $templateId = $pdf->importPage(1); // 导入源PDF的第一页

        // 获取源页面的原始尺寸（FPDI返回的是点，需要转换为毫米）
        // 1点 = 1/72英寸，1英寸 = 25.4毫米
        $templateSize = $pdf->getTemplateSize($templateId);
        $sourceWidthPt = $templateSize['width'];
        $sourceHeightPt = $templateSize['height'];

        $sourceWidthMm = $sourceWidthPt * ($inchToMm / 72);
        $sourceHeightMm = $sourceHeightPt * ($inchToMm / 72);

        echo "源PDF尺寸：宽度 " . round($sourceWidthMm, 2) . "mm, 高度 " . round($sourceHeightMm, 2) . "mm\n";
        echo "目标页面尺寸：宽度 " . round($targetPageWidthMm, 2) . "mm, 高度 " . round($targetPageHeightMm, 2) . "mm\n";

        // 计算需要多少行和多少列才能覆盖整个源页面
        $cols = ceil($sourceWidthMm / $targetPageWidthMm);
        $rows = ceil($sourceHeightMm / $targetPageHeightMm);

        echo "将生成 " . $rows . " 行，" . $cols . " 列，总计 " . ($rows * $cols) . " 页。\n";

        // 循环生成每一片页面
        for ($row = 0; $row < $rows; $row++) {
            for ($col = 0; $col < $cols; $col++) {
                // 添加一个新页面，尺寸为目标页面尺寸
                $pdf->AddPage('P', [$targetPageWidthMm, $targetPageHeightMm]);

                // 计算当前分片在源页面上的起始坐标（毫米）
                // 我们需要将源模板向左上方移动，以便当前分片区域对齐新页面的左上角
                $offsetX = -$col * $targetPageWidthMm;
                $offsetY = -$row * $targetPageHeightMm;

                // 将源模板放置到新页面上
                // useTemplate的参数：模板ID, X坐标, Y坐标, 宽度, 高度
                // 这里的宽度和高度应是源模板的原始尺寸，以保持其比例和分辨率
                $pdf->useTemplate($templateId, $offsetX, $offsetY, $sourceWidthMm, $sourceHeightMm);
            }
        }

        // 输出PDF到文件
        $pdf->Output($outputPdfPath, 'F');
        echo "PDF分片成功，输出文件：{$outputPdfPath}\n";
        return true;

    } catch (Exception $e) {
        echo "处理PDF时发生错误：" . $e->getMessage() . "\n";
        return false;
    }
}

// --- 使用示例 ---
$sourcePdf = 'large_pattern.pdf'; // 替换为您的源PDF文件路径
$outputPdf = 'tiled_pattern_output.pdf'; // 输出文件路径
$letterWidth = 8.5; // Letter纸张宽度（英寸）
$letterHeight = 11; // Letter纸张高度（英寸）

// 确保您的源PDF文件存在于脚本可访问的路径
// 您可以创建一个简单的测试PDF，例如一个24x96英寸的空白PDF，或者使用您实际的缝纫图案PDF。
// 如果没有，可以手动创建一个名为 large_pattern.pdf 的文件用于测试。

if (tileLargePdf($sourcePdf, $outputPdf, $letterWidth, $letterHeight)) {
    echo "请检查 {$outputPdf} 文件。\n";
} else {
    echo "PDF分片处理失败。\n";
}

?>

如何运行此代码：

将上述代码保存为 tile_pdf.php。
在与 tile_pdf.php 相同的目录下创建一个名为 large_pattern.pdf 的大型PDF文件作为测试输入。
通过命令行执行 php tile_pdf.php。
脚本执行完成后，您将在同一目录下找到 tiled_pattern_output.pdf 文件，其中包含了分片后的多页PDF。

注意事项与进阶考量

单位转换： FPDF默认使用毫米（mm）作为单位，而FPDI获取的模板尺寸通常是点（pt）。在进行计算时，务必进行正确的单位转换（1英寸 = 25.4毫米，1点 = 1/72英寸）。
内存消耗： 对于极大的PDF文件或包含大量复杂矢量图形的PDF，处理过程可能会消耗较多内存。如果遇到内存限制问题，可以尝试调整PHP的memory_limit配置。
页面重叠（Overlap）： 对于需要物理拼接的文档（如缝纫图案），通常建议在分片边缘增加少量的重叠区域（例如5-10毫米），以便于精确对齐和裁剪。当前示例代码实现了精确的无缝分片。如需重叠，您需要在计算$offsetX和$offsetY时，将$targetPageWidthMm和$targetPageHeightMm替换为包含重叠部分的有效尺寸，并在AddPage时使用实际的纸张尺寸。例如，如果希望每页之间有5mm的重叠： $effectiveTileWidthMm = $targetPageWidthMm - $overlapMm;$effectiveTileHeightMm = $targetPageHeightMm - $overlapMm; 然后用$effectiveTileWidthMm和$effectiveTileHeightMm来计算$cols、$rows、$offsetX和$offsetY。
页码选择： 示例代码只处理了源PDF的第一页。如果您的源PDF有多个页面需要分片，您需要循环调用importPage()和后续的分片逻辑。
错误处理： 示例代码中包含了基本的错误处理，但在生产环境中，您可能需要更健壮的异常捕获和日志记录机制。
字体和复杂内容： FPDI对大多数PDF内容支持良好，包括文本、图形和图像。但对于一些非常复杂的PDF特性（如3D模型、交互式表单、JavaScript等），FPDI可能无法完全支持。
商业解决方案： Setasign（FPDI的开发者）也提供了更强大的商业级PDF库SetaPDF，它提供了更丰富的功能和更优的性能，如果您的项目对PDF操作有更高要求，可以考虑。