DOMPDF 教程：HTML 到 PDF 转换器
2026-01-16 10:22:59作者：卓艾滢Kingsley
1. 项目介绍
DOMPDF 是一个用于 PHP 的开源库，它能够将 HTML 和 CSS 转换成高质量的 PDF 文件。这个库以 CSS 2.1 标准为基础，支持样式表（包括外部样式表和内联样式），以及大多数的 HTML 属性。DOMPDF 使用了 PDFLib 或者 R&OS CPDF 类来生成 PDF 输出。对于性能和内存效率，推荐使用 PDFLib 扩展。
2. 项目快速启动
安装依赖
首先，确保你的系统已经安装了 Composer，然后在你的项目目录下运行以下命令来添加 DOMPDF 作为项目的依赖：
composer require dompdf/dompdf
基本使用
下面是一个简单的示例，展示如何使用 DOMPDF 将 HTML 内容转换成 PDF：
<?php
require_once 'vendor/autoload.php';
use Dompdf\Dompdf;
// 创建 DOMPDF 实例
$dompdf = new Dompdf();
// 加载 HTML 内容
$html = <<<HTML
<html>
<body>
<h1>Hello, DOMPDF!</h1>
</body>
</html>
HTML;
// 渲染 HTML 到 PDF
$dompdf->loadHtml($html);
// 设置页面大小和方向
$dompdf->setPaper('A4', 'portrait');
// 渲染 PDF
$dompdf->render();
// 输出或保存 PDF
$dompdf->stream('example.pdf');
上述代码将在浏览器中下载一个名为 example.pdf 的文件。
3. 应用案例和最佳实践
多页 PDF
如果你需要创建多页 PDF，确保你的 HTML 包含适当的分页标记，如 <div class="pagebreak">。之后，你可以使用 CSS 来控制这些分页点：
.pagebreak {
page-break-after: always;
}
自定义字体
要使用自定义字体，你需要将其嵌入到 PDF 中。可以使用 @font-face 规则定义字体，并指定 src 为本地文件路径：
@font-face {
font-family: 'MyCustomFont';
src: local('MyCustomFont.ttf');
}
配置设置
DOMPDF 提供了一些配置选项，可以在创建实例时进行设置，例如：
$dompdf = new Dompdf([
'enable_remote' => true,
'default_paper_size' => 'letter',
]);
4. 典型生态项目
- Laravel-DomPDF：这是 DOMPDF 与 Laravel 框架集成的一个包，方便在 Laravel 中使用。仓库链接
通过结合 Laravel 的便利性和 DOMPDF 的功能，你可以轻松地在 Laravel 应用程序中实现动态 PDF 生成。只需在服务提供者中注册并调用 PDF::make() 方法即可。
至此，你应该对 DOMPDF 工具有了基本的了解，准备好了开始你的 PDF 制作之旅。祝你好运！
登录后查看全文
相关内容推荐
热门项目推荐
相关项目推荐
kernelopenEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。C0100
baihu-dataset异构数据集“白虎”正式开源——首批开放10w+条真实机器人动作数据，构建具身智能标准化训练基座。00
mindquantumMindQuantum is a general software library supporting the development of applications for quantum computation.Python059
PaddleOCR-VLPaddleOCR-VL 是一款顶尖且资源高效的文档解析专用模型。其核心组件为 PaddleOCR-VL-0.9B，这是一款精简却功能强大的视觉语言模型（VLM）。该模型融合了 NaViT 风格的动态分辨率视觉编码器与 ERNIE-4.5-0.3B 语言模型，可实现精准的元素识别。Python00
GLM-4.7GLM-4.7上线并开源。新版本面向Coding场景强化了编码能力、长程任务规划与工具协同，并在多项主流公开基准测试中取得开源模型中的领先表现。 目前，GLM-4.7已通过BigModel.cn提供API，并在z.ai全栈开发模式中上线Skills模块，支持多模态任务的统一规划与协作。Jinja00
AgentCPM-Explore没有万亿参数的算力堆砌，没有百万级数据的暴力灌入，清华大学自然语言处理实验室、中国人民大学、面壁智能与 OpenBMB 开源社区联合研发的 AgentCPM-Explore 智能体模型基于仅 4B 参数的模型，在深度探索类任务上取得同尺寸模型 SOTA、越级赶上甚至超越 8B 级 SOTA 模型、比肩部分 30B 级以上和闭源大模型的效果，真正让大模型的长程任务处理能力有望部署于端侧。Jinja00
最新内容推荐
项目优选
收起
kerneldeepin linux kernel
C
27
11
docsOpenHarmony documentation | OpenHarmony开发者文档
Dockerfile
477
3.56 K
ohos_react_nativeReact Native鸿蒙化仓库
JavaScript
287
340
flutter_flutter暂无简介
Dart
728
175
pytorchAscend Extension for PyTorch
Python
287
320
ops-math本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。
C++
849
446
kernelopenEuler内核是openEuler操作系统的核心，既是系统性能与稳定性的基石，也是连接处理器、设备与服务的桥梁。
C
235
98
nop-entropyNop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用
Java
10
1
torchairTorchAir 支持用户基于PyTorch框架和torch_npu插件在昇腾NPU上使用图模式进行推理。
Python
450
180
RuoYi-Vue3🎉 (RuoYi)官方仓库 基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统
Vue
1.28 K
705