fpdf原生不支持utf-8中文,需替换为支持中文的ttf字体并用makefont.php生成字体文件,或直接改用mpdf/tcpdf;动态内容需手动调用cell()/multicell()写入;输出空白多因http头污染,应检查bom、缓冲区及前置输出。

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逻辑。你得手动拼接数据、控制位置、分页。
立即学习“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();
关键点:
稻草人企业站程序,是一款简单开源的企业站程序,程序分为php+sqlite、php+mysql两个版本,程序采用php+smarty模板技术 修改模板方便,程序采用面对对象 模块开发.调用管理方便,程序可以开启伪静态功能,后台能编辑删除文件,后台能进行数据库管理、备份等操作,生成百度sitemap、Google sitemap功能,留言发邮件功能。 稻草人企业站程序 v1.0.7升级 1、增加安
-
Cell()适合单行固定宽高内容,MultiCell()自动换行,但无法跨页续写 - 所有变量(如
$order_id)必须提前准备好,不能在Cell()里嵌套复杂表达式 - HTML标签(如
<br>)不会被解析,需手动换行或拆成多个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更现实:
- 直接
writeHTML()传入含<table>和内联<code>style的字符串 - 自动处理中文字体(只需指定
msi或simhei) - 支持
@pageCSS规则控制页眉页脚 - 错误提示清晰,比如
Unable to find TTF font file比FPDF的静默失败好调试得多
别为了“轻”硬扛FPDF——多引入一个Composer包(mpdf/mpdf)换来的是可维护性,不是性能瓶颈。










