本文档旨在详细介绍 dompdf 中 `$pdf` 变量的含义及其用法，并深入探讨如何利用 `page_text` 函数在生成的 pdf 文档中添加自定义文本，特别是在需要进行分页和在特定页面添加内容时。通过本文，您将能够理解如何在 php 代码和 html 模板中使用这些功能，并掌握 dompdf 的高级用法，从而更好地控制 pdf 文档的生成。
## 理解 Dompdf 中的 $pdf 变量 在 Dompdf 中，`$pdf` 变量是一个在页面脚本中可用的特殊变量，它代表了 `Canvas` 对象的一个引用。`Canvas` 对象提供了对底层 PDF 写入后端（如 `CPDF`）的直接访问。因此，你可以使用 `$pdf` 变量以及 `Canvas` 对象提供的方法来直接操作 PDF 文档的内容。 需要注意的是，`Canvas` 对象主要用于绘制原始的 PDF 元素，例如文本、线条和形状。它**不**支持直接渲染 HTML 代码。这意味着你不能像使用 HTML 元素那样，直接将包含样式信息的 HTML 代码传递给 `Canvas` 对象的方法。所有文本的样式，例如字体、大小和颜色，都必须手动设置。 ## 使用 page_text 函数添加文本 `page_text` 函数是 `Canvas` 对象的一个方法，它允许你在 PDF 文档的每一页上添加文本。与 `Canvas` 对象的其他方法（如 `text`）不同，`page_text` 函数是在 HTML 文档完全渲染后，针对每一页执行的。这使得它非常适合添加页眉、页脚、页码等需要在每一页上重复出现的内容。 以下是如何使用 `page_text` 函数的示例： **PHP 代码中：** ```php true]); // 加载 HTML 内容 $html = 'Hello, Dompdf!
This is page 1.
This is page 2.
'; $dompdf->loadHtml($html); // (Optional) 设置纸张大小和方向 $dompdf->setPaper('A4', 'portrait'); // 渲染 HTML 为 PDF $dompdf->render(); // 获取 Canvas 对象 $canvas = $dompdf->getCanvas(); // 获取 FontMetrics 对象 $fontMetrics = $dompdf->getFontMetrics(); // 使用 page_script 添加页码 $canvas->page_script(function($pageNumber, $pageCount, $fontMetrics) use ($canvas) { $font = $fontMetrics->get_font("helvetica", "bold"); $canvas->page_text(540, 815, "Page $pageNumber of $pageCount", $font, 8, array(0,0,0)); }); // 输出 PDF 到浏览器 $dompdf->stream("dompdf_output.pdf", ["Attachment" => false]); ?>HTML 代码中（需要启用 PHP）：
在上面的例子中，PAGE_NUM 和 PAGE_COUNT 是 Dompdf 提供的预定义常量，分别代表当前页码和总页数。这些常量只能在 HTML 嵌入的 PHP 脚本中使用。
注意事项：
动态WEB网站中的PHP和MySQL：直观的QuickPro指南第2版
下载
动态WEB网站中的PHP和MySQL详细反映实际程序的需求，仔细地探讨外部数据的验证(例如信用卡卡号的格式)、用户登录以及如何使用模板建立网页的标准外观。动态WEB网站中的PHP和MySQL的内容不仅仅是这些。书中还提到如何串联JavaScript与PHP让用户操作时更快、更方便。还有正确处理用户输入错误的方法，让网站看起来更专业。另外还引入大量来自PEAR外挂函数库的强大功能，对常用的、强大的包
- 为了在 HTML 代码中使用 PHP 脚本，你需要在实例化 Dompdf 对象时启用 isPhpEnabled 选项。
- Font_Metrics::get_font() 方法用于获取字体对象，你需要指定字体名称和样式（例如 "helvetica", "bold"）。
- $pdf->page_text() 方法的参数依次为：x 坐标、y 坐标、文本内容、字体对象、字体大小和颜色（RGB 数组）。
在特定页面添加内容
你可以结合条件判断语句，在特定页面上添加内容。例如，以下代码只会在第二页上添加页眉：
使用 Canvas 对象直接操作 PDF
除了使用 page_text 函数，你还可以使用 Canvas 对象的其他方法来直接操作 PDF 文档。例如，你可以使用 text 方法在当前页面的指定位置添加文本，使用 line 方法绘制线条，使用 rectangle 方法绘制矩形等等。
以下是一个使用 text 方法添加文本的例子：
Hello, Dompdf!