DOMPDF 教程:HTML 到 PDF 转换器
dompdfHTML to PDF converter for PHP项目地址:https://gitcode.com/gh_mirrors/do/dompdf
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 制作之旅。祝你好运!
dompdfHTML to PDF converter for PHP项目地址:https://gitcode.com/gh_mirrors/do/dompdf