本文介绍如何在 php 中利用 fpdi 库，将用户上传的 pdf 作为模板，动态填充或叠加内容并生成新的 pdf 文件，适用于合同、证书、报表等场景。
在 PHP 开发中，若需基于用户上传的 PDF 模板（如已设计好的合同、发票或证书）生成个性化 PDF，直接修改原始 PDF 内容不可行——因为 PDF 是静态格式，不支持原生文本插入。此时，推荐使用 FPDI（Free PDF Importer）配合 TCPDF 或 FPDF 实现“模板复用”：FPDI 负责导入并定位模板页面，再通过底层绘图 API 叠加文字、图像等动态内容。
✅ 推荐技术栈：FPDI + FPDF（轻量可靠）
FPDI 是一个成熟、开源且无需外部依赖的 PHP 库，专为导入现有 PDF 页面而设计。它不修改源文件，而是将其作为背景“画布”，再调用 FPDF 的 Cell()、MultiCell()、Image() 等方法在指定坐标写入动态数据。
? 快速上手示例
以下代码演示如何加载本地 PDF 模板（如 template.pdf），在第一页右上角添加客户姓名，并输出浏览器下载：
魔法映像企业网站管理系统
下载
技术上面应用了三层结构，AJAX框架，URL重写等基础的开发。并用了动软的代码生成器及数据访问类，加进了一些自己用到的小功能，算是整理了一些自己的操作类。系统设计上面说不出用什么模式，大体设计是后台分两级分类，设置好一级之后，再设置二级并选择栏目类型，如内容，列表，上传文件，新窗口等。这样就可以生成无限多个二级分类，也就是网站栏目。对于扩展性来说，如果有新的需求可以直接加一个栏目类型并新加功能操作
setSourceFile($templatePath);
// 导入第一页（MediaBox 坐标系）
$tplId = $pdf->importPage(1, PdfReader\PageBoundaries::MEDIA_BOX);
// 添加新页面（尺寸与模板一致）
$pdf->addPage();
$pdf->useImportedPage($tplId, 0, 0, 0, 0); // 全页铺满
// 在坐标 (100, 50) 处添加动态文本（单位：mm）
$pdf->SetFont('Helvetica', '', 12);
$pdf->SetTextColor(0, 0, 0);
$pdf->SetXY(100, 50);
$pdf->Cell(0, 10, '客户姓名：张三', 0, 1);
// 输出 PDF（I=inline 浏览器预览；D=强制下载）
$pdf->Output('D', 'filled-contract.pdf');
?>? 关键说明： $_FILES['template_file']['tmp_name'] 即前端 上传后的临时路径，务必先校验文件类型（mime == application/pdf）和大小； useImportedPage() 的后四个参数为 x, y, width, height，设为 0,0,0,0 表示按原始尺寸居左上角放置； 若需精确对齐（如填写表单字段），建议用 Adobe Acrobat 测量目标位置的 X/Y 坐标（单位 mm），再传入 SetXY()。
⚠ 注意事项与最佳实践
- 安全第一：严禁直接使用用户上传的文件名构造路径（防路径遍历）。应生成唯一随机名（如 uniqid().'.pdf'），并保存至非 Web 可访问目录；
- 模板限制：FPDI 仅支持 PDF 1.4 及以下版本；加密 PDF 需先解密（FPDI 不支持密码解析）；
- 中文支持：默认字体不支持中文。如需显示中文，请改用 TCPDF + addTTFfont() 加载 .ttf 字体，或选用支持 UTF-8 的 mpdf（但 mpdf 对复杂模板兼容性略弱）；
- 性能提示：大批量生成时，避免频繁 new Fpdi()，可复用实例或改用队列异步处理。
✅ 替代方案简析
| 方案 | 适用场景 | 备注 |
|---|---|---|
| FPDI + TCPDF | 需要丰富排版/中文/HTML 转 PDF | 功能强但体积大，学习成本略高 |
| mPDF | 模板含 HTML/CSS，需快速渲染 | 支持 writeHTML()，但 PDF 模板导入能力不如 FPDI 稳定 |
| Dompdf | 纯 HTML 模板优先 | 不支持导入现有 PDF，仅适合从零生成 |
掌握 FPDI 后，你即可构建可靠的 PDF 模板引擎——无论是电子签章前置、学生成绩单批量生成，还是个性化营销物料输出，都能以极小开销实现专业级交付。
立即学习“PHP免费学习笔记（深入）”；
