TCPDF适合生成结构固定、需条码的发票，但不支持现代CSS和base64图片；Dompdf渲染HTML更友好但需禁用JS、显式声明字体路径并启用isRemoteEnabled才能加载远程图。
直接用 TCPDF 或 Dompdf 就能生成 PDF，但选错库、配错字体、传错内容格式，十次有八次导出失败或中文变方块。别碰 mPDF 和 wkhtmltopdf——前者 PHP 8.2+ 兼容性不稳，后者要服务器权限且命令注入风险高。
为什么 TCPDF 写发票稳，但别用它渲染订单页
TCPDF 是纯 PHP 实现，没外部依赖，适合后台逻辑驱动的 PDF（比如带条码、固定表格结构的发票）。但它对 HTML 的解析非常原始：writeHTML() 不支持 float、flex、background-image，更不认 @media print；图片只接受服务端真实路径，data:image/png;base64 直接报错。
- 中文必须提前注册字体：把
simhei.ttf放进fonts/目录，再调用$pdf->addTTFfont('fonts/simhei.ttf', 'TrueTypeUnicode', '', 32) - 别用
writeHTML()塞大段带样式的 HTML；改用Cell()或MultiCell()手动控制每行宽度和高度 - 长中文段落会按字符截断，“中华人民共和国”可能被切成“中华人民共/和国”，解决办法是先用
str_split($text, $max_len)切行，再逐行Cell() - 生成 >10MB 的 PDF 时，
memory_limit至少设为 512M，max_execution_time要 ≥ 120
Dompdf 渲染 HTML 快，但你得写“退化版”代码
Dompdf 对前端友好，但不是浏览器——它不执行 JS、不 fetch 远程资源、不解析 @import，CSS 支持停留在 2012 年水平。你写的 Bootstrap 页面，90% 的样式在它眼里是无效的。
- 字体必须用
@font-face显式声明，且路径是服务器绝对路径，例如/var/www/fonts/simhei.ttf，不能是 URL 或相对路径 - 中文内容必须在
<body>上加style="font-family: simhei;"，否则默认字体不支持中文，显示成方块 - 图片只读本地文件：
<img src="/tmp/chart.png">可以，<img src="https://example.com/logo.png">默认忽略，除非显式启用$dompdf->set_option('isRemoteEnabled', true) - 别传 URL 给
loadHtml()；先用file_get_contents()拿到完整 HTML 字符串再传入
内存爆掉、超时、空白页？先查这三处
报 Fatal error: Allowed memory size of ... exhausted 或页面空白，大概率不是代码写错了，而是环境配置或内容本身越界了。
立即学习“PHP免费学习笔记（深入）”；
-
Dompdf渲染含高清图或百行表格的 HTML，内存占用是原始 HTML 的 4–6 倍；建议先压缩图片、拆分长表格、禁用isPhpEnabled选项 -
TCPDF卡在Maximum execution time exceeded，常见于启用了setHeaderCallback()且回调里做了数据库查询或远程请求 - 所有中文字体路径必须可读且编码为 UTF-8；Linux 下注意 SELinux 或 AppArmor 是否阻止了字体文件访问
- 生成前用
is_readable($font_path)和mb_detect_encoding($html) === 'UTF-8'快速验证基础条件
真正卡住的从来不是“怎么调 API”，而是字体路径是否真实存在、HTML 字符串是否已完全预渲染、内存限制是否覆盖了渲染峰值——这三处漏一个，PDF 就不会出来。
