PHP与FPDI：高效拆分大型PDF页面以实现分片打印

<?php

// 引入Composer自动加载文件
require_once __DIR__ . '/vendor/autoload.php';

use setasign\Fpdi\Fpdi;

/**
 * 将大型单页PDF拆分为多个标准尺寸页面
 *
 * @param string $inputPdfPath 输入的大型PDF文件路径
 * @param string $outputPdfPath 输出的分片PDF文件路径
 * @param float $targetPageWidth 目标页面宽度 (单位: mm)
 * @param float $targetPageHeight 目标页面高度 (单位: mm)
 * @throws Exception 如果文件不存在或处理失败
 */
function tileLargePdf(string $inputPdfPath, string $outputPdfPath, float $targetPageWidth, float $targetPageHeight): void
{
    if (!file_exists($inputPdfPath)) {
        throw new Exception("输入PDF文件不存在: " . $inputPdfPath);
    }

    try {
        $pdf = new Fpdi();

        // 设置源PDF文件
        $pageCount = $pdf->setSourceFile($inputPdfPath);

        if ($pageCount < 1) {
            throw new Exception("输入PDF文件不包含任何页面。");
        }

        // 导入源PDF的第一页作为模板 (假设大型PDF只有一页)
        $templateId = $pdf->importPage(1);

        // 获取导入模板的原始尺寸
        $originalPageDimensions = $pdf->getTemplateSize($templateId);
        $originalPageWidth = $originalPageDimensions['width'];
        $originalPageHeight = $originalPageDimensions['height'];

        echo "原始PDF页面尺寸: " . round($originalPageWidth, 2) . "mm x " . round($originalPageHeight, 2) . "mm\n";
        echo "目标分片页面尺寸: " . round($targetPageWidth, 2) . "mm x " . round($targetPageHeight, 2) . "mm\n";

        // 计算水平和垂直方向所需的分片数量
        $tilesX = ceil($originalPageWidth / $targetPageWidth);
        $tilesY = ceil($originalPageHeight / $targetPageHeight);

        echo "所需分片数量: 水平 " . $tilesX . " x 垂直 " . $tilesY . " = " . ($tilesX * $tilesY) . " 个\n";

        // 循环生成每个分片页面
        for ($row = 0; $row < $tilesY; $row++) {
            for ($col = 0; $col < $tilesX; $col++) {
                // 计算当前分片在原始PDF中的起始X和Y坐标
                // 这些坐标是原始页面上我们希望显示在当前新页面左上角的内容的坐标
                $srcX = $col * $targetPageWidth;
                $srcY = $row * $targetPageHeight;

                // 添加一个新的页面到输出PDF，尺寸为目标分片尺寸
                // 'P' 表示纵向 (Portrait)，也可以根据需要使用 'L' 横向 (Landscape)
                $pdf->AddPage('P', [$targetPageWidth, $targetPageHeight]);

                // 使用导入的模板
                // 参数解释:
                // 1. $templateId: 导入的模板ID
                // 2. -$srcX: 模板在当前页面上的X轴起始位置。
                //           我们希望原始PDF中 ($srcX, $srcY) 的内容出现在新页面的 (0,0) 位置。
                //           因此，需要将整个原始模板向左移动 $srcX，向上移动 $srcY。
                // 3. -$srcY: 模板在当前页面上的Y轴起始位置。
                // 4. $originalPageWidth: 模板在当前页面上的渲染宽度。
                //                       这里设置为原始页面的宽度，以保持原始比例和尺寸。
                // 5. $originalPageHeight: 模板在当前页面上的渲染高度。
                //                       设置为原始页面的高度。
                // FPDF会自动裁剪超出当前页面边界的内容。
                $pdf->useTemplate($templateId, -$srcX, -$srcY, $originalPageWidth, $originalPageHeight);

                echo "已生成第 " . ($row * $tilesX + $col + 1) . " 个分片 (原始坐标: " . round($srcX, 2) . "mm, " . round($srcY, 2) . "mm)\n";
            }
        }

        // 输出生成的PDF文件
        $pdf->Output($outputPdfPath, 'F'); // 'F' 表示保存到文件

        echo "\nPDF分片完成。输出文件: " . $outputPdfPath . "\n";

    } catch (Exception $e) {
        throw new Exception("PDF处理过程中发生错误: " . $e->getMessage());
    }
}

// --- 使用示例 ---
$inputPdf = 'large_pattern.pdf'; // 替换为你的大型PDF文件路径
$outputPdf = 'tiled_pattern_output.pdf'; // 输出文件路径

// 定义目标页面尺寸 (Letter尺寸，单位: 毫米)
// 1英寸 = 25.4毫米
$letterWidth = 8.5 * 25.4;  // 215.9 mm
$letterHeight = 11 * 25.4; // 279.4 mm

try {
    tileLargePdf($inputPdf, $outputPdf, $letterWidth, $letterHeight);
} catch (Exception $e) {
    echo "错误: " . $e->getMessage() . "\n";
}

?>