php 8.5尚未发布,当前最新稳定版为php 8.3;tcpdf是php 8.1+推荐的pdf生成方案,需composer安装、禁用默认页眉页脚、显式加载中文字体、本地化处理图片,并避免使用已不兼容php 8.2+的fpdf。

PHP 8.5 还不存在,目前最新稳定版是 PHP 8.3(截至 2024 年中),所以 php8.5pdf 是个无效关键词,所有基于“PHP 8.5”的 PDF 生成方案都不存在,也无需适配。
用 TCPDF 生成 PDF 的实际步骤(PHP 8.1+ 兼容)
TCPDF 是目前最成熟的纯 PHP PDF 库,PHP 8.1–8.3 下运行稳定,但要注意几个关键点:
- 必须用 Composer 安装:运行
composer require tecnickcom/tcpdf,别手动下载旧 ZIP 包(容易缺 autoload 或路径错) - 初始化时别漏掉
setPrintHeader(false)和setPrintFooter(false),否则默认页眉页脚会遮挡内容 - 中文需显式设置字体:用
addTTFfont()加载simhei.ttf等 TrueType 字体,再用setFont('simhei', '', 12)切换,直接传 UTF-8 字符串会乱码 - 不支持
file_get_contents('https://...')直接读远程图片——得先curl下来存临时文件,再用Image()加载本地路径
FPDF 不兼容 PHP 8.2+,别踩这个坑
原生 FPDF(fpdf.php 单文件版)在 PHP 8.2+ 会报 Deprecated: Creation of dynamic property ... 错误,本质是它用动态属性模拟类成员,PHP 8.2 禁用了该行为。你看到的“能跑”只是错误被静默忽略,实际输出 PDF 可能损坏或缺失文字。
- 替代方案只有两个:
tcpdf(功能全、稍重)或mpdf(更现代,对 HTML/CSS 支持更好) - 如果硬要沿用 FPDF 风格 API,可用
fpdi+tcpdf组合,但没必要——直接上tcpdf更省事 - 别信网上“注释掉几行就能跑”的改法,那些 patch 没覆盖所有动态属性场景,PDF 结构出错很难调试
生成 PDF 时常见报错和对应解法
不是代码写错,而是环境或配置没对齐:
立即学习“PHP免费学习笔记(深入)”;
-
Cannot modify header information - headers already sent:检查echo、var_dump、BOM 字节或文件末尾空行——PDF 输出前不能有任何输出 -
Some data has already been output, can't send PDF file:和上面同源,用ob_get_level()查当前输出缓冲层数,必要时加ob_end_clean() - 生成的 PDF 打不开 / 显示“损坏的文件”:大概率是
Output()前调了exit()或异常中断,导致 PDF 头/尾不完整;建议用Output('file.pdf', 'F')先存本地验证内容是否正常 - 表格跨页断裂、文字被截断:TCPDF 默认不自动分页,要用
checkPageBreak()+setY()手动控制,或改用writeHTML()渲染带 CSS 的 HTML 片段(它内置分页逻辑)
真正麻烦的从来不是“怎么生成”,而是字体嵌入、页眉页脚精确定位、表格自动撑开、以及导出后 Acrobat 提示“缺少嵌入字体”。这些细节在 TCPDF 文档里藏得深,又没法靠查 Stack Overflow 一次解决——得对着 PDF 规范和 TCPDF 源码里的 _putfonts() 函数来回比对。











