本文介绍如何在 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），在第一页右上角添加客户姓名，并输出浏览器下载：
<?php
require_once 'vendor/autoload.php'; // 推荐使用 Composer 安装
use setasign\Fpdi\Fpdi;
use setasign\Fpdi\PdfReader;
// 初始化 FPDI 实例（兼容 FPDF 接口）
$pdf = new Fpdi();
// 导入模板文件（支持本地路径或 $_FILES 临时上传路径）
$templatePath = $_FILES['template_file']['tmp_name'] ?? 'template.pdf';
$pageCount = $pdf->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'] 即前端 <input type="file" name="template_file"> 上传后的临时路径，务必先校验文件类型（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免费学习笔记（深入）”；
