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

登录后查看全文