PDF总页数非4的倍数时，如何在文档开头添加补页？

问题核心是在文档开头补页时，初始阶段$pdf->getNumPages()返回0——因为此时PDF还未生成任何内容，无法获取真实总页数。要实现需求，必须先完整生成PDF内容，再插入空白页到开头。

方法一：使用支持页面插入的PDF库（如TCPDF） #

如果使用TCPDF，它自带InsertPage方法可直接在指定位置插入页面，步骤如下：

1. 先完成所有PDF内容的生成（添加页面、写入内容等）；
2. 计算需要补充的页数，确保总页数为4的倍数；
3. 循环插入空白页到文档开头。

示例代码：

// 先执行所有原有内容生成代码，比如：
// $pdf->AddPage();
// $pdf->Write(10, '原有内容');
// ...

$total = $pdf->getNumPages();
// 计算需要补的页数：若总页数是4的倍数则补0页，否则补(4 - 余数)页
$needed = (4 - ($total % 4)) % 4;

if ($needed > 0) {
    // 在第1页之前插入空白页
    for ($i = 0; $i < $needed; $i++) {
        $pdf->InsertPage(1, 'P', 'A5');
    }
}

// 输出最终PDF
$pdf->Output();

方法二：原生FPDF（需借助FPDI） #

原生FPDF没有直接插入页面的方法，可通过创建新PDF、先加补页再导入原内容的方式实现：

1. 生成包含所有内容的原PDF；
2. 创建新PDF，先添加所需数量的空白补页；
3. 借助FPDI库将原PDF的所有页面导入到新PDF中。

示例代码：

require_once('fpdf.php');
require_once('fpdi.php');

// 生成原内容PDF
$originalPdf = new FPDF('P', 'mm', 'A5');
// 执行原有内容生成逻辑
// $originalPdf->AddPage();
// $originalPdf->Write(10, '原有内容');
// ...

$originalTotal = $originalPdf->getNumPages();
$needed = (4 - ($originalTotal % 4)) % 4;

// 创建新PDF并添加补页
$newPdf = new FPDI('P', 'mm', 'A5');
for ($i = 0; $i < $needed; $i++) {
    $newPdf->AddPage();
}

// 导入原PDF的所有页面到新PDF
for ($pageNum = 1; $pageNum <= $originalTotal; $pageNum++) {
    $newPdf->AddPage();
    // 导入原页面并添加到新PDF
    $template = $newPdf->importPage($pageNum);
    $newPdf->useTemplate($template);
}

// 输出最终PDF
$newPdf->Output();

注意点 #

原末尾补页的代码逻辑存在问题：若总页数为5（5%4=1），原代码会补1页，总页数变为6，仍不是4的倍数。正确的补页数量应为(4 - ($total % 4)) % 4，确保补页后总页数是4的倍数。

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