Dompdf安装失败需先确认PHP≥8.0，否则用^1.2版本并启用mbstring/xml扩展；中文乱码须手动注册Noto Sans CJK字体；页面截断应避免vh单位、调整纸张设置；内存溢出需精简HTML、提升PHP限制，复杂报表建议换工具。
composer require dompdf/dompdf 装不上？先确认 PHP 版本和扩展
Dompdf 2.x 要求 PHP ≥ 8.0，如果你用的是 PHP 7.4 或更低版本，composer require dompdf/dompdf 会直接报错或装上低版本（如 1.2.x），后者不支持现代 CSS Flex/Grid，转 PDF 时样式大面积丢失。
检查方法：php -v；如果版本不够，要么升级 PHP，要么明确指定兼容旧版的 tag：
-
composer require dompdf/dompdf:^1.2（仅限 PHP 7.2–7.4） - 同时确保
mbstring和xml扩展已启用——Dompdf 依赖它们解析 HTML 和处理字符编码，缺一不可 - Windows 下若提示
failed to open stream: No such file or directory，大概率是 Composer 缓存损坏，试下composer clear-cache
HTML 转 PDF 时中文乱码？字体路径和注册方式最关键
Dompdf 默认不带中文字体，直接渲染含中文的 HTML 会显示方块或空白。不能只靠 font-family: "SimSun" 这种 CSS 声明——它压根不认识系统字体。
必须手动加载并注册字体文件（如 Noto Sans CJK）：
立即学习“前端免费学习笔记（深入）”；
- 下载
NotoSansCJKsc-Regular.ttf到项目目录，比如resources/fonts/ - 在 PHP 里调用
Dompdf\Options::set('fontDir', __DIR__ . '/resources/fonts') - 再用
Dompdf\FontMetrics::register_font()注册字体名与文件映射，否则@font-face或 CSS 中的font-family不生效 - 别用绝对路径硬编码字体位置，优先用
__DIR__或dirname(__FILE__)动态拼接
生成 PDF 后页面截断、内容溢出？调整纸张和渲染模式
Dompdf 渲染本质是“模拟浏览器排版”，但它不支持 position: fixed、transform 或复杂 flex-wrap，且默认把整个 HTML 当作单页渲染，超出 A4 高度就直接砍掉。
常见对策：
- 用
Dompdf\Options::set('isRemoteEnabled', true)允许加载远程 CSS/图片（但注意安全，生产环境慎开） - 设置
margin和page-size：比如Dompdf\Options::set('defaultPaperSize', 'A4')、Dompdf\Options::set('defaultPaperOrientation', 'portrait') - 避免用
height: 100vh或min-height: 100%——Dompdf 对视口单位支持极弱，换成具体 px 或 cm 更稳 - 表格内容超长时，加
table { page-break-inside: avoid; }可减少跨页撕裂，但不能保证 100% 不断行
内存溢出或超时？不是代码写错了，是 HTML 太重
Dompdf 是纯 PHP 实现，解析大 HTML（尤其含大量 inline SVG、Base64 图片或嵌套 table）时极易触发 Fatal error: Allowed memory size exhausted 或 Maximum execution time exceeded。
实际能做的优化很有限，但以下三点最有效：
- 用
ob_start()+ob_get_clean()预渲染 HTML 字符串，而不是传 URL 或动态 include——减少 I/O 和上下文切换开销 - 生成前调高限制：
ini_set('memory_limit', '512M')、set_time_limit(300)（注意：共享主机通常禁用set_time_limit） - 彻底删掉 HTML 中无用的
script、style（Dompdf 不执行 JS，也不需要完整 CSS，只留关键打印样式即可）
真要处理复杂报表，Dompdf 就不是最优选——它适合轻量合同、票据类场景，别拿它硬扛后台导出百万级数据的 PDF。
