README

Dompdf 是一个 HTML 到 PDF 转换器

在核心上，dompdf 是一个（主要）符合 CSS 2.1 规范的 HTML 布局和渲染引擎，用 PHP 编写。它是一个基于样式的渲染器：它会下载并读取外部样式表、内联样式标签和单个 HTML 元素的样式属性。它还支持大多数表现性 HTML 属性。

本文件适用于最新稳定代码，可能无法反映当前版本。对于已发布代码，请导航到适当的标签。

查看示例，并在 StackOverflow 或 Google Groups 上提出任何问题。

在 或 上关注我们。

功能

• 处理大多数 CSS 2.1 和一些 CSS3 属性，包括 @import、@media 和 @page 规则
• 支持大多数表现性 HTML 4.0 属性
• 支持外部样式表，可以是本地或通过 http/ftp（通过 fopen 包装器）
• 支持复杂表格，包括行和列跨、单独和折叠的边框模型、单个单元格样式
• 图像支持（gif、png（8、24 和 32 位带 alpha 通道）、bmp 和 jpeg）
• 由于 R&OS PDF 类，无需依赖外部 PDF 库
• 内联 PHP 支持
• 基本的 SVG 支持

要求

• PHP 版本 5.4.0 或更高
• DOM 扩展
• GD 扩展
• MBString 扩展
• php-font-lib
• php-svg-lib

建议

• OPcache（OPcache、XCache、APC 等.）：提高性能
• IMagick 或 GMagick 扩展：提高图像处理性能

有关更多信息，请访问 wiki：https://github.com/dompdf/dompdf/wiki/Requirements

关于字体和字符编码

PDF 文档内部支持以下字体：Helvetica、Times-Roman、Courier、Zapf-Dingbats 和 Symbol。这些字体仅支持 Windows ANSI 编码。为了使 PDF 显示 Windows ANSI 中不可用的字符，您必须提供外部字体。Dompdf 会将任何引用的字体嵌入到 PDF 中，前提是它已被预加载或可由 dompdf 访问，并参考 CSS @font-face 规则。有关如何使用字体的更多信息，请参阅字体概述。

DejaVu TrueType 字体已被预安装，以便 dompdf 默认提供良好的 Unicode 字符覆盖。要使用 DejaVu 字体，请在样式表中引用字体，例如 body { font-family: DejaVu Sans; }（用于 DejaVu Sans）。以下 DejaVu 2.34 字体可供使用：DejaVu Sans、DejaVu Serif 和 DejaVu Sans Mono。

简单安装

使用 Composer 安装

要使用 Composer 安装，只需要求此软件包的最新版本。

composer require dompdf/dompdf

确保加载了 Composer 的自动加载文件。

// somewhere early in your project's loading, require the Composer autoloader
// see: https://getcomposer.org.cn/doc/00-intro.md
require 'vendor/autoload.php';

下载和安装

下载 dompdf 的存档并将其解压到 dompdf 将驻留的目录中

• 您可以从 https://github.com/dompdf/dompdf/releases 下载稳定版本的 dompdf
• 或从 http://eclecticgeek.com/dompdf 下载夜间版（最新的未发布代码）

使用打包的发布自动加载器在 PHP 中加载 dompdf、库和辅助函数

// include autoloader
require_once 'dompdf/autoload.inc.php';

使用 git 安装

在命令行中，切换到 dompdf 将驻留的目录，并运行以下命令

git clone https://github.com/dompdf/dompdf.git
cd dompdf

git clone https://github.com/PhenX/php-font-lib.git lib/php-font-lib
cd lib/php-font-lib
git checkout 0.5.1
cd ..

git clone https://github.com/PhenX/php-svg-lib.git php-svg-lib
cd php-svg-lib
git checkout v0.3

在 PHP 中要求 dompdf、库和辅助函数

require_once 'dompdf/lib/html5lib/Parser.php';
require_once 'dompdf/lib/php-font-lib/src/FontLib/Autoloader.php';
require_once 'dompdf/lib/php-svg-lib/src/autoload.php';
require_once 'dompdf/src/Autoloader.php';
Dompdf\Autoloader::register();

快速入门

只需将您的 HTML 传递给 dompdf 并流式传输输出

// reference the Dompdf namespace
use Dompdf\Dompdf;

// instantiate and use the dompdf class
$dompdf = new Dompdf();
$dompdf->loadHtml('hello world');

// (Optional) Setup the paper size and orientation
$dompdf->setPaper('A4', 'landscape');

// Render the HTML as PDF
$dompdf->render();

// Output the generated PDF to Browser
$dompdf->stream();

设置选项

在实例化 dompdf 时设置选项

use Dompdf\Dompdf;
use Dompdf\Options;

$options = new Options();
$options->set('defaultFont', 'Courier');
$dompdf = new Dompdf($options);

或在运行时

use Dompdf\Dompdf;

$dompdf = new Dompdf();
$dompdf->set_option('defaultFont', 'Courier');

有关可用选项的列表，请参阅 Dompdf\Options。

局限性（已知问题）

• Dompdf 对格式错误的 HTML 输入不是很容忍。为了避免任何意外的渲染问题，您应该要么在运行时启用内置的 HTML5 解析器（$dompdf->set_option('isHtml5ParserEnabled', true);），要么通过 HTML 验证器/清洁器（如 Tidy 或 W3C Markup Validation Service）运行您的 HTML。
• 大文件或大表格可能需要一段时间才能渲染。
• CSS 浮动仍在开发中，可能无法产生预期的结果

如果您觉得这个项目有用，请考虑捐赠。所有捐赠的资金将用于进一步开发此项目。）