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 制作之旅。祝你好运！

dompdf

HTML to PDF converter for PHP

项目地址：https://gitcode.com/gh_mirrors/do/dompdf

登录后查看全文

项目优选

收起

kernel

deepin linux kernel

docs

OpenHarmony documentation | OpenHarmony开发者文档

🔥LeetCode solutions in any programming language | 多种编程语言实现 LeetCode、《剑指 Offer（第 2 版）》、《程序员面试金典（第 6 版）》题解

🎉 (RuoYi)官方仓库基于SpringBoot，Spring Security，JWT，Vue3 & Vite、Element Plus 的前后端分离权限管理系统

Nop Platform 2.0是基于可逆计算理论实现的采用面向语言编程范式的新一代低代码开发平台，包含基于全新原理从零开始研发的GraphQL引擎、ORM引擎、工作流引擎、报表引擎、规则引擎、批处理引引擎等完整设计。nop-entropy是它的后端部分，采用java语言实现，可选择集成Spring框架或者Quarkus框架。中小企业可以免费商用

Java

gitea

喝着茶写代码！最易用的自托管一站式代码托管平台，包含Git托管，代码审查，团队协作，软件包和CI/CD。

ops-math

本项目是CANN提供的数学类基础计算算子库，实现网络在NPU上加速计算。

🎉 基于Spring Boot、Spring Cloud & Alibaba、Vue3 & Vite、Element Plus的分布式前后端分离微服务架构权限管理系统