使用PHP和FPDI实现大型PDF页面分块打印教程

composer require fpdf/fpdf setasign/fpdi

<?php

require_once('vendor/autoload.php'); // 如果使用Composer安装

use setasign\Fpdi\Fpdi;

/**
 * 将大型PDF页面分割为多个标准尺寸页面进行打印
 *
 * @param string $sourcePdfPath 源PDF文件路径
 * @param string $outputPdfPath 输出PDF文件路径
 * @param array $targetPageSize 目标页面尺寸，例如 ['width' => 215.9, 'height' => 279.4] (单位：mm)
 * @param string $orientation 目标页面方向 'P' (Portrait) 或 'L' (Landscape)
 */
function splitLargePdfForPrinting(
    string $sourcePdfPath,
    string $outputPdfPath,
    array $targetPageSize = ['width' => 215.9, 'height' => 279.4], // US Letter in mm
    string $orientation = 'P'
): void {
    // 创建FPDI对象，并设置单位为毫米
    $pdf = new Fpdi('P', 'mm', [$targetPageSize['width'], $targetPageSize['height']]);

    // 设置字体，确保PDF内容正常显示（可选，但推荐）
    $pdf->SetFont('Helvetica', '', 10);

    // 导入源PDF文件
    $pageCount = $pdf->setSourceFile($sourcePdfPath);

    // 假设我们只处理第一页（对于单页大图）
    if ($pageCount < 1) {
        throw new Exception("源PDF文件不包含任何页面。");
    }
    $templateId = $pdf->importPage(1);

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

    // 定义目标页面尺寸（例如US Letter）
    $targetWidth = $targetPageSize['width'];
    $targetHeight = $targetPageSize['height'];

    // 计算水平和垂直方向所需的瓦片（tile）数量
    $numCols = ceil($originalWidth / $targetWidth);
    $numRows = ceil($originalHeight / $targetHeight);

    echo "原始页面尺寸: {$originalWidth}mm x {$originalHeight}mm\n";
    echo "目标页面尺寸: {$targetWidth}mm x {$targetHeight}mm\n";
    echo "需要 {$numCols} 列 x {$numRows} 行 = " . ($numCols * $numRows) . " 页\n";

    // 循环生成每个分块页面
    for ($row = 0; $row < $numRows; $row++) {
        for ($col = 0; $col < $numCols; $col++) {
            // 添加新页面，尺寸为目标页面尺寸
            $pdf->AddPage($orientation, [$targetWidth, $targetHeight]);

            // 计算当前瓦片在原始页面中的左上角偏移量
            // 注意：useTemplate的x, y参数是模板在当前页面的左上角位置。
            // 为了显示原始页面的一部分，我们需要将整个原始页面作为模板，
            // 然后通过负的x, y偏移量来“裁剪”出我们想要的部分。
            $offsetX = -$col * $targetWidth;
            $offsetY = -$row * $targetHeight;

            // 使用模板，并指定其在当前页面的位置和尺寸
            // 这里我们传入原始页面的完整宽度和高度，让FPDI在内部进行裁剪和定位
            $pdf->useTemplate($templateId, $offsetX, $offsetY, $originalWidth, $originalHeight);

            // 可选：添加页码或裁剪线等辅助信息
            // $pdf->SetXY(5, 5);
            // $pdf->Cell(0, 10, "Page " . ($row * $numCols + $col + 1), 0, 1, 'L');
        }
    }

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

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

    // 定义US Letter尺寸（毫米）
    $letterSize = ['width' => 215.9, 'height' => 279.4];

    // 如果源PDF是横向的，且你希望输出的每页也是横向的，可以调整 $orientation
    splitLargePdfForPrinting($sourcePdf, $outputPdf, $letterSize, 'P');

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