如何制作兼容Mpdf、支持其覆写功能修改的PDF文档？

mPDF的Overwrite方法确实仅支持mPDF自身生成、或使用完全相同加密/压缩规则的PDF文件，要让现有PDF兼容该方法，核心是先将PDF转换为mPDF原生规范的格式，以下是可落地的实现方案：

方案1：导入现有PDF重生成mPDF兼容格式（最通用） #

该方案不需要源文件，直接对现有PDF做格式归一，需要先安装Fpdi扩展用于PDF导入：

composer require setasign/fpdi

执行PDF导入重输出，得到的新PDF就可以支持Overwrite方法，代码示例：

<?php
require_once __DIR__ . '/vendor/autoload.php';

// 初始化mPDF，开启Fpdi支持
$mpdf = new \Mpdf\Mpdf();
$pageCount = $mpdf->setSourceFile('your_existing.pdf');

// 逐页导入原PDF内容
for ($i = 1; $i <= $pageCount; $i++) {
    $template = $mpdf->importPage($i);
    $mpdf->AddPage();
    $mpdf->useTemplate($template);
}

// 输出为mPDF原生格式的PDF，此时该文件已兼容Overwrite功能
$mpdf->Output('mpdf_compatible.pdf', 'F');

// 接下来就可以正常调用Overwrite做文本替换
$mpdf->OverWrite('mpdf_compatible.pdf', '%%NAME%%', 'CHRIS', 'F', 'new_test.pdf');
?>

方案2：通过源文件重新生成（稳定性最高） #

如果你持有现有PDF的源文件（如HTML、Word、Markdown格式），直接将源文件通过mPDF渲染生成带占位符的PDF，生成的文件天然支持Overwrite功能，不需要额外格式转换。

特殊情况处理：加密PDF预处理 #

如果现有PDF设置了权限密码或加密，需要先解密后再做格式转换，可以使用qpdf命令行工具完成解密：

qpdf --decrypt encrypted_input.pdf decrypted_output.pdf

解密完成后再走方案1的重生成流程即可。

注意事项 #

• 若原PDF为扫描件，本身不存在可识别的文本层，Overwrite的文本替换功能无法生效，需要先做OCR识别提取文本后再处理
• 部分带复杂矢量元素、自定义字体的PDF导入重生成后可能出现排版偏移，建议转换后先校验格式
• 占位符建议使用特殊字符包裹（如你当前用的%%），避免替换时匹配到普通文本

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