使用 PHP 和 FPDI 实现大型 PDF 页面的平铺打印与分割

composer require setasign/fpdf
composer require setasign/fpdi

<?php

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

use setasign\Fpdi\Fpdi;

/**
 * 将大型单页 PDF 分割为多个标准尺寸页面
 *
 * @param string $sourcePdfPath 原始大型 PDF 文件的路径
 * @param string $outputPdfPath 输出的分割后 PDF 文件的路径
 * @param float $targetPageWidth 目标页面的宽度 (单位: mm)
 * @param float $targetPageHeight 目标页面的高度 (单位: mm)
 */
function splitLargePdfForTiling(string $sourcePdfPath, string $outputPdfPath, float $targetPageWidth = 215.9, float $targetPageHeight = 279.4)
{
    // 创建一个新的 FPDI 实例
    $pdf = new Fpdi();

    // 导入原始 PDF
    $pageCount = $pdf->setSourceFile($sourcePdfPath);
    if ($pageCount === 0) {
        throw new Exception("无法读取源 PDF 文件或文件为空。");
    }

    // 假设原始 PDF 只有一页，获取其模板 ID
    $templateId = $pdf->importPage(1);

    // 获取原始页面的尺寸
    $originalPageSize = $pdf->getTemplateSize($templateId);
    $originalWidth = $originalPageSize['width'];
    $originalHeight = $originalPageSize['height'];

    // 计算需要平铺的行数和列数
    // 向上取整，确保所有内容都被覆盖
    $numCols = ceil($originalWidth / $targetPageWidth);
    $numRows = ceil($originalHeight / $targetPageHeight);

    echo "原始尺寸: {$originalWidth}x{$originalHeight} mm\n";
    echo "目标尺寸: {$targetPageWidth}x{$targetPageHeight} mm\n";
    echo "将分割为 {$numRows} 行 x {$numCols} 列\n";

    // 遍历所有需要生成的平铺页面
    for ($row = 0; $row < $numRows; $row++) {
        for ($col = 0; $col < $numCols; $col++) {
            // 添加新页面，尺寸为目标页面的尺寸
            // 默认方向为 Portrait (P)，如果目标页面是 Landscape (L) 需要调整
            $pdf->AddPage('P', [$targetPageWidth, $targetPageHeight]);

            // 计算当前平铺块在原始 PDF 中的起始坐标
            $sourceX = $col * $targetPageWidth;
            $sourceY = $row * $targetPageHeight;

            // 使用 useTemplate 将原始 PDF 的特定区域放置到当前新页面上
            // 参数说明: useTemplate(templateId, x, y, width, height, adjustX, adjustY, adjustWidth, adjustHeight)
            // x, y, width, height: 目标页面上的位置和尺寸 (通常是 0, 0, targetPageWidth, targetPageHeight)
            // adjustX, adjustY, adjustWidth, adjustHeight: 原始模板中要截取的区域
            // FPDI 的 useTemplate 方法的参数签名是 useTemplate($tplId, $x = 0, $y = 0, $width = 0, $height = 0, $adjustCurrentPageSize = false)
            // 截取特定区域需要通过计算 x, y, width, height 来实现，FPDI 会自动裁剪超出部分。
            // 更精确的裁剪通常需要将模板放置后，再通过 SetXY 和 Write 等方式控制内容显示。
            // 对于平铺，我们直接将模板放置到新页面，超出新页面的部分会被自动裁剪。
            // 关键在于计算原始模板的起始点，并将其放置到新页面的 (0,0) 位置。
            // 原始模板内容在目标页面上的实际偏移量是 -sourceX 和 -sourceY
            $pdf->useTemplate(
                $templateId,
                -$sourceX, // 模板在目标页面上的 X 偏移量
                -$sourceY, // 模板在目标页面上的 Y 偏移量
                $originalWidth, // 模板在目标页面上的宽度 (保持原始比例，但会被目标页面裁剪)
                $originalHeight // 模板在目标页面上的高度
            );

            // 可选: 在每个平铺页面上添加标记或裁剪线，方便后期拼接
            // $pdf->SetFont('Arial', 'B', 8);
            // $pdf->Text(5, 5, "Page " . ($row * $numCols + $col + 1) . " of " . ($numRows * $numCols));
        }
    }

    // 输出 PDF
    $pdf->Output('F', $outputPdfPath);
    echo "PDF 分割完成，输出到: {$outputPdfPath}\n";
}

// 示例用法
try {
    $sourcePdf = 'path/to/your/large_pattern.pdf'; // 替换为你的大型 PDF 文件路径
    $outputPdf = 'output_tiled_pattern.pdf';

    // Letter 纸张尺寸 (8.5 x 11 英寸转换为毫米)
    $letterWidthMM = 215.9;
    $letterHeightMM = 279.4;

    splitLargePdfForTiling($sourcePdf, $outputPdf, $letterWidthMM, $letterHeightMM);

} catch (Exception $e) {
    echo '发生错误: ' . $e->getMessage();
}

?>