PHP中使用FPDI插入PDF时宽于A4的文件无法缩放的问题求助

我之前用FPDI处理PDF合并缩放的时候也踩过这个坑！官方示例有时候没讲透细节，导致没法生效。咱们直接上能跑的解决方案，一步步来：

核心思路 #

要把超出A4尺寸的PDF页面按比例缩放，并居中放置在A4页面内，关键是要手动计算缩放因子和偏移量，而不是直接用导入页面的尺寸来创建新页面。

完整可运行代码示例 #

// 初始化FPDI，默认使用A4页面设置
$objPDF = new \setasign\Fpdi\Fpdi();

// 待插入的目标PDF文件路径
$targetPdfPath = 'your-existing-document.pdf';
// 获取目标PDF的总页数
$pageCount = $objPDF->setSourceFile($targetPdfPath);

// 循环处理每一页
for ($intPageNumber = 1; $intPageNumber <= $pageCount; $intPageNumber++) {
    // 导入当前页面
    $varPageId = $objPDF->ImportPage($intPageNumber);
    // 获取导入页面的原始尺寸信息
    $varTemplateSize = $objPDF->getTemplateSize($varPageId);

    // A4标准可打印尺寸（默认单位为mm）
    $a4Width = 210;
    $a4Height = 297;

    // 计算缩放比例：取宽、高方向缩放因子的最小值，确保页面完全适配A4
    $scaleWidth = $a4Width / $varTemplateSize['width'];
    $scaleHeight = $a4Height / $varTemplateSize['height'];
    $scaleFactor = min($scaleWidth, $scaleHeight);

    // 计算缩放后的页面尺寸
    $scaledWidth = $varTemplateSize['width'] * $scaleFactor;
    $scaledHeight = $varTemplateSize['height'] * $scaleFactor;

    // 计算居中偏移量，让缩放后的页面在A4中居中显示
    $offsetX = ($a4Width - $scaledWidth) / 2;
    $offsetY = ($a4Height - $scaledHeight) / 2;

    // 添加A4页面，同步原始页面的横竖方向
    $objPDF->AddPage(
        $varTemplateSize['orientation'] === 'L' ? 'L' : 'P',
        [$a4Width, $a4Height]
    );

    // 缩放并绘制导入的页面到当前A4页面上
    $objPDF->useTemplate($varPageId, $offsetX, $offsetY, $scaledWidth, $scaledHeight);
}

// 输出最终的A4适配PDF（'I'表示在浏览器中打开，'F'表示保存到文件）
$objPDF->Output('final-a4-ready.pdf', 'I');

为什么官方示例可能没生效？ #

你提到的官方代码片段里，大概率只做了页面导入和尺寸获取，但没有手动计算缩放因子，也没在useTemplate方法中指定缩放后的宽高参数。FPDI默认不会自动缩放导入的页面，必须显式传入这些参数才能触发缩放逻辑。

另外还有几个要注意的细节：

• 确保单位统一：FPDI默认单位是毫米，如果你自定义了单位，要同步调整A4尺寸的数值
• 处理横竖方向：如果原始PDF是横向页面，AddPage时要对应设置方向，避免页面被强制挤压成纵向
• 检查PDF加密：如果待插入的PDF是加密状态，可能会导致尺寸获取失败，需要先解密再处理

内容的提问来源于stack exchange，提问作者Jan Zelenka