Composer如何安装DOMPDF生成PDF_Composer安装DOMPDF生成PDF指南-composer-PHP中文网

dompdf 是通过 composer 安装的 php 类库，需用 composer require dompdf/dompdf 而非 composer install；安装后需手动编写 php 脚本调用 dompdf 类渲染 html 为 pdf，依赖 mbstring 和 gd 扩展，且不支持 flex/grid 等现代 css。

composer如何安装dompdf生成pdf_composer安装dompdf生成pdf指南

DOMPDF 不是 Composer 的“安装目标”，而是通过 Composer 安装的 PHP 库；你真正要做的，是用 composer require 加入 dompdf/dompdf，再手动加载或配合自动加载使用 —— 它本身不提供命令行工具，也不自动生成 PDF。

为什么 `composer install dompdf` 会报错？

因为 composer install 只读取当前项目的 composer.json 并安装依赖，它不接受包名作为参数。想加 DOMPDF，必须用 composer require。

composer install dompdf/dompdf → 报错：Unknown command "install" 或类似提示
正确命令是：composer require dompdf/dompdf
如果项目没初始化过 Composer，先运行 composer init 或直接 composer require（会自动创建 composer.json）
国内用户建议提前配置镜像源，否则可能卡在下载 dompdf/dompdf 或其依赖 phenx/php-font-lib 上

安装后怎么用？不是执行一个命令就出 PDF

DOMPDF 是一个类库，不是 CLI 工具。你需要写 PHP 脚本，实例化 Dompdf 类，传入 HTML 字符串，再调用 render() 和 output()。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

确保已启用 PHP 的 mbstring 和 gd 扩展（DOMPDF 渲染字体和图像依赖它们）

最简可用示例：

<?php require 'vendor/autoload.php';

use Dompdf\Dompdf;

$dompdf = new Dompdf();
$dompdf->loadHtml('<h1>Hello World</h1>');
$dompdf->setPaper('A4', 'portrait');
$dompdf->render();
$dompdf->stream('hello.pdf');

注意：$dompdf->stream() 会直接输出 PDF 到浏览器并终止脚本；如需保存文件，改用 $dompdf->output() 获取二进制内容，再用 file_put_contents()

常见报错和对应处理

DOMPDF 错误往往不直观，但高频问题就那几个：

Class 'Dompdf\Dompdf' not found → 检查是否漏了 require 'vendor/autoload.php'，或命名空间拼写错误（比如写成 DOMPDF 或 dompdf）
Failed to load PDF document（前端报错）→ 实际是 PHP 输出了警告/错误（如未启用 mbstring），导致 PDF 流被污染；用 ob_clean() + flush() 前置清理输出缓冲，或先用 error_reporting(0) 快速验证
中文乱码或空白 → DOMPDF 默认不支持中文字体；必须显式注册字体（如 Noto Sans CJK），并确保字体文件路径可读，且在 HTML 中用 font-family 指定
大 HTML 渲染超时 → DOMPDF 内存占用高；可通过 ini_set('memory_limit', '512M') 临时放宽限制，但更稳妥的是精简 HTML 结构、避免复杂 CSS 布局