登录
首页 >  文章 >  php教程

PHP生成PDF教程：FPDF库使用指南

时间：2026-03-01 10:27:45 312浏览 收藏

本文深入解析了使用FPDF库在PHP中生成PDF时的三大核心痛点：中文乱码、动态内容写入困难及输出空白问题，并给出了切实可行的解决方案——从手动配置中文字体、谨慎使用Cell/MultiCell控制布局，到排查BOM、输出缓冲等HTTP头污染陷阱；同时客观指出FPDF在现代开发中的局限性，强烈推荐更成熟、开箱即用的替代方案如MPDF或TCPDF，它们原生支持UTF-8、HTML渲染、CSS样式和自动分页，显著提升开发效率与项目可维护性。

PHP文件怎么转成PDF_用FPDF库生成文档简单操作【教程】

FPDF生成PDF时中文显示乱码怎么办

FPDF原生不支持UTF-8中文，直接输出中文会变成方块或空格。核心原因是它默认只加载Type1字体（如helvetica），而这些字体没有中文字符集。

解决路径只有两个：要么用iconv()或mb_convert_encoding()把中文转成CP1252（极不可靠，仅限ASCII扩展字符），要么换字体。推荐后者：

  • 下载支持中文的TTF字体（如simhei.ttf或msyh.ttc）
  • 用MakeFont.php工具（FPDF官方提供）生成PHP字体描述文件（.php）和字形文件（.z）
  • 把生成的两个文件放进font/目录，并在代码中调用AddFont()

注意：MakeFont.php必须在命令行运行，且依赖ttf2ufm工具；Windows用户容易卡在这一步——建议直接用tcpdf或mpdf替代，它们开箱支持UTF-8。

怎么把PHP动态内容写进PDF页面

FPDF不是模板引擎，不能像file_get_contents('template.php')那样直接渲染PHP逻辑。你得手动拼接数据、控制位置、分页。

典型流程是：AddPage() → SetFont() → 用Cell()、MultiCell()、Write()逐块写入内容。例如：

$pdf = new FPDF();
$pdf->AddPage();
$pdf->AddFont('simhei', '', 'simhei.php');
$pdf->SetFont('simhei', '', 12);
$pdf->Cell(0, 10, '订单号：' . $order_id, 0, 1);
$pdf->MultiCell(0, 6, '客户留言：' . htmlspecialchars_decode($message));
$pdf->Output();

关键点：

  • Cell()适合单行固定宽高内容，MultiCell()自动换行，但无法跨页续写
  • 所有变量（如$order_id）必须提前准备好，不能在Cell()里嵌套复杂表达式
  • HTML标签（如
    ）不会被解析，需手动换行或拆成多个MultiCell()

FPDF输出PDF失败但页面空白，怎么排查

常见原因不是代码错，而是HTTP头污染。FPDF的Output()会发送Content-Type: application/pdf，一旦之前有echo、var_dump()、BOM头、空格或错误警告，就会导致PDF损坏，浏览器显示空白。

快速检查项：

  • 确认PHP文件保存为UTF-8无BOM格式（编辑器里看编码选项）
  • 执行前加ob_clean();和ob_end_clean();清空输出缓冲
  • 临时注释掉所有非FPDF相关echo/print_r，再试
  • 把Output()改成Output('F', '/tmp/test.pdf')先写到服务器磁盘，验证文件是否生成成功

如果写磁盘成功但浏览器输出失败，基本就是输出缓冲或header冲突问题。

为什么不用FPDF而选MPDF或TCPDF

FPDF轻量（一个类文件），但功能边界明显：不支持CSS、不解析HTML、不处理图片缩放、不自动分页表格、不兼容PHP 8.1+部分strict模式。实际项目中，只要涉及动态表格、样式、中文、图片混排，FPDF很快会卡住。

MPDF更现实：