PHP生成PDF文件_使用TCPDF库生成PDF文档【技巧】-php教程-PHP中文网

tcpdf 中文显示方块因默认字体不支持utf-8，须三步解决：选中文字体（如simhei.ttf）、用ttf2ufm.php转换为.php/.z文件并放入fonts目录、再setfont()指定；html表格需用内联style和语义化标签；大文件要控制分页、压缩图片、禁用页眉页脚；中文文件名应避免直接使用，推荐ascii命名。

php生成pdf文件_使用tcpdf库生成pdf文档【技巧】

为什么 TCPDF 生成的中文显示为方块或乱码

根本原因是 TCPDF 默认字体不支持 UTF-8 中文。它内置的 helvetica、times 等字体是西方字符集，直接写入中文会触发字形缺失，表现为方块或空白。

解决方式不是“换字体”那么简单，而是必须完成三步：选择支持中文的 TrueType 字体（如 simhei.ttf 或 msyh.ttf）、用 addTTFfont() 将其转换为 TCPDF 可识别的 .php 和 .z 字体文件、再通过 setFont() 指定使用。

别直接把 Windows 字体目录下的 simhei.ttf 拷进项目就调用——TCPDF 不认原始 ttf 文件
转换命令必须在命令行执行：php tcpdf/fonts/utils/ttf2ufm.php -f -F simhei.ttf（路径需按你实际安装位置调整）
转换后生成的 simhei.php 和 simhei.z 必须放在 tcpdf/fonts/ 目录下，否则 addFont() 找不到
调用时字体名用的是文件名前缀（如 simhei），不是完整文件名或系统字体名

如何让 TCPDF 正确处理 HTML 表格和内联样式

TCPDF 的 writeHTML() 支持有限 HTML 子集，对 CSS 的解析非常保守。常见问题包括：border-collapse: collapse 被忽略、padding 不生效、float 完全无效、display: flex 直接崩溃。

安全做法是回归语义化标签 + 行内 style 属性，并手动控制单元格边框与间距：

表格必须显式写 <table border="1">，不能依赖 CSS <code>border
单元格内边距靠 <td style="padding: 5px;">，不要用 class <li>避免 <code>colspan/rowspan 嵌套过深，TCPDF 对跨行计算容易错位
图片建议用绝对 URL（如 https://example.com/img/logo.png），相对路径在 CLI 环境下常 404

示例片段：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

订单号：

#20240501

生成大文件时内存溢出或超时怎么办

TCPDF 在内存中构建整份 PDF，内容越长、图像越多，消耗越大。典型报错是 Fatal error: Allowed memory size of XXX bytes exhausted 或 Maximum execution time of XX seconds exceeded。

先调高限制（临时）：ini_set('memory_limit', '512M'); 和 set_time_limit(300);，但只是掩耳盗铃
真正有效的是分页控制：用 addPage() 显式分页，避免单页塞太多内容；对长列表，每 50 行左右强制 addPage()
图像务必压缩并指定尺寸：<img src="..." style="max-width:90%" style="max-width:90%">，否则 TCPDF 会尝试加载原始分辨率，吃光内存
禁用页眉页脚缓存（如果不需要动态内容）：$pdf->setPrintHeader(false); $pdf->setPrintFooter(false);

导出文件名含中文时浏览器下载失败或乱码

HTTP 头中的 Content-Disposition 对中文文件名支持极差，Chrome 和 Firefox 解析逻辑不同，IE 更是完全不兼容。

最稳妥方案是只用 ASCII 文件名，同时在响应体里补充可读提示：

文件名固定为英文，比如 invoice_20240501.pdf，由 PHP 生成带时间戳的唯一名
若业务强要求显示中文名，用 mb_convert_encoding() 做 RFC 5987 编码（仅 Chrome/Firefox 支持），但 Safari 和旧版 Edge 会退化为空名
绝对不要用 iconv('UTF-8', 'GB2312', $name) 这类粗暴转码，会导致部分浏览器解析失败

推荐写法：

header('Content-Type: application/pdf');
header('Content-Disposition: inline; filename="invoice_' . date('YmdHis') . '.pdf"');
// 不做中文 filename 尝试，避免不可控 fallback

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！