搜索psliwa / php-pdf
PHP PDF 和图形文件生成库。
Requires
- zendframework/zend-cache: ^2.0
- zendframework/zendpdf: ~2.0.0
Requires (Dev)
- imagine/imagine: >=0.2.0,<0.6.0
- phpunit/phpunit: >=4,<5.4.0
- zendframework/zend-barcode: ^2.0
- zendframework/zend-validator: ^2.0
Suggests
- imagine/Imagine: If you want to use image generating (required version: >=v0.2.6)
- zendframework/zend-barcode: If you want to use barcodes
- zendframework/zend-validator: If you want to use barcodes (required by zend-barcode)
README
示例
示例文档位于 "examples" 目录中。 "index.php" 文件是浏览示例的 Web 界面，"cli.php" 是控制台界面。通过 Web 界面，文档以 pdf 和 jpeg 格式提供（jpeg 格式需要 Imagick）。
文档
目录
- 简介
- 安装
- Symfony2 扩展包
- 常见问题解答
- 文档解析和创建 PDF 文件
- 基本文档结构
- 继承
- 样式表结构
- 颜色调板
- 标准标签
- 属性
- 复杂属性
- 单位
- 条形码
- 图表
- 超链接
- 书签
- 粘性注释
- 重复页眉和页脚
- 水印
- 页码
- 使用 PDF 文档作为模板
- 在列中分离页面
- 断页和列
- 元数据
- 配置
- Markdown 支持
- [图像生成引擎] (#image-generation)
- 已知限制
- 待办事项 - 计划
- 技术要求
简介
PHPPdf 是一个库，它将 XML 文档转换为 PDF 文档或图形文件。XML 源文档类似于 HTML，但在属性名称和属性、标签属性以及存在大量非标准标签、并非所有 HTML 标签都受支持，样式表在 XML 文档中描述，而不是在 CSS 中。
此库的假设不是 HTML -> PDF / JPEG / PNG，而是 XML -> PDF / JPEG / PNG 转换。一些标签和属性与 HTML 相同，以减少此库的学习曲线。
安装
PHPPdf 可在 packagist.org 上找到，因此您可以使用 composer 下载此库及其所有依赖项。
(在您的 composer.json 文件的 require 部分中添加)
"psliwa/php-pdf": "*"
您应选择最后一个稳定版本（或稳定版本的通配符），通配符字符 ("*") 仅是一个示例。
如果您想使用条形码或图像生成等功能，您应添加额外的依赖项
"zendframework/zend-barcode": ">=2.0.0,<2.4", "zendframework/zend-validator": ">=2.0.0,<2.4", "imagine/Imagine": ">=0.2.0,<0.6.0"
Symfony2 扩展包
有一个 Symfony2 扩展包，该扩展包将此库与 Symfony2 框架集成。
常见问题解答
重音符号不显示，我该怎么办？
您应该设置一个支持您所使用的编码的字体，并将此编码设置为 "page" 和/或 "dynamic-page" 标签的 "encoding" 属性。PHPPdf 提供了一些支持 utf-8 编码的免费字体，例如 DejaVuSans。 "Font" 示例显示了如何通过使用样式表来更改字体类型。
您还可以添加自定义字体，为此您应准备 xml 配置文件并配置 Facade 对象，如下所示
<!-- xml config file code --> <fonts> <font name="DejaVuSans"> <normal src="%resources%/fonts/DejaVuSans/normal.ttf" /><!-- "%resources%" will be replaced by path to PHPPdf/Resources directory --> <bold src="%resources%/fonts/DejaVuSans/bold.ttf" /> <italic src="%resources%/fonts/DejaVuSans/oblique.ttf" /> <bold-italic src="%resources%/fonts/DejaVuSans/bold+oblique.ttf" /> <light src="%resources%/fonts/DejaVuSans/light.ttf" /> <light-italic src="%resources%/fonts/DejaVuSans/light+oblique.ttf" /> </font> </fonts>
//php code $loader = new PHPPdf\Core\Configuration\LoaderImpl(); $loader->setFontFile(/* path to fonts configuration file */); $builder = PHPPdf\Core\FacadeBuilder::create($loader); $facade = $builder->build();
<!-- xml document code --> <pdf> <dynamic-page encoding="UTF-8" font-type="DejaVuSans"> </dynamic-page> </pdf>
您可以在 配置 部分中找到更多信息。
生成带有 png 图像的简单 PDF 文件需要很长时间和内存，我该怎么办？
PHPPdf 使用 Zend_Pdf 库，该库对未压缩的 png 文件支持不佳。您应该压缩 png 文件。
我如何更改页面大小/方向？
要设置页面尺寸，您使用页面或动态页面标签的 "page-size" 属性。
此属性的值语法为 "width:height"。
然而，也有一些标准预定义值
- 格式：从4A0到A10
- B格式：从B0到B10
- C格式：从C0到C10
- 美国尺寸：法律和信纸
所有格式都支持横竖排版。
示例
<page page-size="100:50">text</page> <page page-size="a4">text</page> <page page-size="letter-landscape">text</page>
文档解析和创建PDF文件
使用库的最简单方法是
//register the PHPPdf and vendor (Zend_Pdf and other dependencies) autoloaders require_once 'PHPPdf/Autoloader.php'; PHPPdf\Autoloader::register(); PHPPdf\Autoloader::register('/path/to/library/lib/vendor/Zend/library'); //if you want to generate graphic files PHPPdf\Autoloader::register('sciezka/do/biblioteki/lib/vendor/Imagine/lib'); $facade = new PHPPdf\Core\Facade(new PHPPdf\Core\Configuration\Loader()); //$documentXml and $stylesheetXml are strings contains XML documents, $stylesheetXml is optional $content = $facade->render($documentXml, $stylesheetXml); header('Content-Type: application/pdf'); echo $content;
基本文档结构
库基于类似于HTML的XML格式，但这不是HTML - 一些标签不同，一些属性的解释与HTML和CSS标准不同，添加属性的方式也不同。
一个简单的文档具有以下结构
<pdf> <dynamic-page> <h1>Header</h1> <p>paragraph</p> <div color="red">Layer</div> <table> <tr> <td>Column</td> <td>Column</td> </tr> </table> </dynamic-page> </pdf>
强烈建议添加DOCTYPE声明，以便在值上替换HTML实体
<!DOCTYPE pdf SYSTEM "%resources%/dtd/doctype.dtd">
文档的根名称必须是"pdf"。 "dynamic-page"标签是一个可自动分页的页面。 "page"标签是替代品，表示一个单一的、不可分页的页面。
属性设置的方与HTML不同。
为了设置背景和边框，需要使用复杂的属性，其中属性名称的第一部分是复杂的属性类型，第二部分是该属性的属性。
复杂的属性部分由点号(".")分隔。
设置复杂属性的另一种方法是使用"complex-attribute"标签。
示例
<pdf> <dynamic-page> <div color="red" border.color="black" background.color="pink"> This text is red on pink backgroun into black border </div> </dynamic-page> </pdf>
替代语法（"stylesheet"标签）
<pdf> <dynamic-page> <div> <stylesheet> <attribute color="red" /> <complex-attribute name="border" color="black" /> <complex-attribute name="background" color="pink" /> </stylesheet> This text is red on pink backgroun into black border </div> </dynamic-page> </pdf>
属性可以作为XML属性设置，直接在标签名称之后，或者使用提到的"stylesheet"标签。HTML中的"style"属性在PHPPdf XML方言中不存在。
库在尊重标签和属性的正确性方面非常严格。如果检测到未存在的标签或属性，文档解析器将停止并抛出异常。
继承
"id"属性的使用方式与HTML不同。id属性用于在使用继承时识别标签。
"name"属性也可以用作"id"的别名。
id必须在整个文档中是唯一的，否则将抛出解析错误。
示例
<pdf> <dynamic-page> <div id="layer-1" color="red" font-type="judson" font-size="16px"> <stylesheet> <complex-attribute name="border" color="green" /> </stylesheet> Layer 1 </div> <div extends="layer-1"> Layer 2 inherits style (type, simple and complex attributes) from layer 1) </div> </dynamic-page> </pdf>
第二层继承了所有属性（简单和复杂），以及来自外部样式的属性。
属性设置的优先级
- 元素标签内的"stylesheet"标签
- 标签名称之后的属性（XML属性）
- 来自外部样式的属性
- 从父标签继承的属性
示例
<pdf> <page> <div id="1" color="#cccccc" height="100px" text-align="right"> </div> <div extends="1" color="#aaaaaa" height="150px"> <stylesheet> <attribute name="height" value="200px" /> </stylesheet> </div> </page> </pdf>
第二个"div"现在将具有以下属性
- text-align: right
- color: #aaaaaa
- height: 200px
样式表结构
样式表定义在外部文件中，支持样式表的短和长属性声明。
样式表的语法
短样式
<stylesheet> <!-- style attributes are embeded as xml attributes, class attribute has the same meaning as in HTML/CSS --> <div class="class" font-size="12px" color="gray" background.color="yellow"> <!-- nested element, equivalent CSS selector syntax: "div.class p" --> <p margin="10px 15px"> </p> </div> <!-- equivalent CSS selector syntax: ".another-class", "any" tag is wildcard (mean any tag) --> <any class="another-class" text-align="right"> </any> <h2 class="header"> <span font-size="9px"> </span> <div font-style="bold"> </div> </h2> </stylesheet>
长样式
<stylesheet> <div class="class"> <!-- simple and complex attributes are nested in "div.class" selector path --> <attribute name="font-size" value="12px" /> <attribute name="color" value="grey" /> <!-- equivalent of background.color attribute --> <complex-attribute name="background" color="yellow" /> <!-- another nested element, equivalent CSS selector syntax: "div.class p" --> <p> <attribute name="margin" value="10px 15px" /> </p> </div> <!-- equivalent CSS selector syntax: ".another-class", "any" tag is wildcard (mean any tag) --> <any class="another-class"> <attribute name="text-align" value="right" /> </any> <h2 class="header"> <span> <attribute name="font-size" value="9px" /> </span> <div> <attribute name="font-style" value="bold" /> </div> </h2> </stylesheet>
颜色调
PHPPdf支持颜色调色板，即逻辑名称到实际颜色的映射。
颜色调色板允许您创建或覆盖默认命名的颜色。默认情况下，PHPPdf支持来自W3C标准的命名颜色（例如"black" = "#000000"）。
您可以使用调色板来遵循DRY原则，因为有关使用颜色的信息将保存在一个地方。您还可以使用不同的调色板生成一个文档。
示例
<!-- colors.xml file --> <colors> <color name="header-color" hex="#333333" /> <color name="line-color" hex="#eeeeee" /> </colors> <!-- stylesheet.xml file --> <h2 color="header-color" /> <hr background-color="line-color" /> <table> <td border-color="line-color" /> </table> <!-- document.xml file --> <pdf> <page> <h2>Header</h2> <hr /> <table> <tr> <td>Data</td> <td>Data</td> </tr> </table> </page> </pdf>
//php code use PHPPdf\DataSource\DataSource; $facade = ...; $content = $facade->render( DataSource::fromFile(__DIR__.'/document.xml'), DataSource::fromFile(__DIR__.'/stylesheet.xml'), DataSource::fromFile(__DIR__.'/colors.xml') );
标准标签
库支持主要的HTML标签：div, p, table, tr, td, b, strong, span, a, h1, h2, h3, h4, h5, img, br, ul, li
此外还有非标准标签
- dynamic-page - 自动分页页面
- page - 具有固定大小的单个页面
- 弹性页面 - 单页，其高度与子元素相同，与其它标签（例如“div”）一致。标题、页脚、水印、模板文档属性不适用于此标签。在图形文件生成（图像引擎）中特别有用。
- 分页、列断、断开 - 断开页面或列，此标签必须是“dynamic-page”或“column-layout”的直接子标签！
- 列布局 - 分隔列的工作空间，附加属性：列数、列间距、等宽列
- 条形码 - 更多信息请参阅条形码章节
- 圆形 - 边框和背景为圆形的元素。附加属性：半径（它覆盖宽度和高度属性）
- 饼图 - 可以用来绘制简单饼图的元素（更多请参阅图表章节）。
有些标签仅用于属性，一组标签等
- 样式表 - 父元素的样式表
- 属性 - 简单属性声明，直接子标签为“stylesheet”标签。此元素的必需属性：name - 属性名称，value - 属性值
- 复杂属性 - 复杂属性声明，直接子标签为“stylesheet”标签。此元素的必需属性：name - 复杂属性名称
- 占位符 - 定义父标签的占位符。占位符的子标签针对每个父标签都是特定的。它应该是父标签的第一个标签
- 元数据 - 定义PDF文档的元数据，直接子标签为文档根
- 行为 - 定义父标签的行为。支持的行为：href、ref、书签、注释（行为与同名的属性相同）
属性
- 宽度与高度：严格设置高度和宽度，支持的单位在单独的章节中描述。支持百分比相对值。
- 最大宽度、最大高度：设置元素的 最大尺寸
- 边距（上边距、下边距、左边距、右边距）：类似于HTML/CSS的边距。相邻元素的边距会合并。对于侧边距，可以使用“auto”值，其效果类似于HTML/CSS。
- 填充（上填充、下填充、左填充、右填充）：类似于HTML/CSS
- 字体类型 - 字体名称必须在fonts.xml配置文件中出现，否则会抛出异常
- 字体大小 - 以点为单位的大小，没有单位
- 字体样式 - 允许的值：normal、bold、italic、bold-italic、light、light-italic
- 颜色 - 文本颜色。支持HTML/CSS风格值
- 可断开 - 如果为true，元素可以跨多页断开。大多数标签的默认值是true。
- 浮动 - 类似于但与HTML/CSS不同。允许的值：left|none|right，默认为none
- 行高 - 类似于HTML/CSS。默认值：1.2*字体大小
- 文本对齐 - 与HTML/CSS相同。允许的值：left|center|right|justify，默认为left。
- 文本装饰 - 允许的值：none、underline、overline、line-through
- 断开 - 在具有此属性的元素的末尾断开页面或列。具有此属性的元素必须是dynamic-page或column-layout标签的直接子标签！
- 跨列、跨行 - 与HTML类似（待办：跨行尚未实现）
- href - 元素应链接的外部URL
- ref - 应链接的元素的ID
- 书签 - 创建具有给定标题的书签，与标签相关联
- 注释 - 创建与标签相关联的粘性注释
- dump - 允许的值：true或false。创建带有调试信息（属性、位置等）的粘性注释
- rotate - 元素旋转角度。此属性未完全实现，对水印有效（见“水印”部分）。可能值：XXdeg（度），XX（弧度），对角线，-对角线。
- alpha - 可能值：从0到1。元素及其子元素的不透明度。
- line-break - 换行（true或false），默认仅对"br"标签设置为true。
- style - 与html中相同，此属性可以用来设置其他属性，例如：style="width: 100px; height: 200px; margin: 20px 0;"。每个属性都必须以";"字符结尾，即使是最后一个。
- ignore-error（仅适用于img标签）- 忽略文件加载错误或抛出异常？默认为false，表示将抛出异常。
- keep-ratio（仅适用于img标签）- 即使设置的尺寸比例与原始源图像的比例不同，也会通过裁剪图像片段来保持比例。默认为false。
- position - 与html中相同。允许值：static（默认），relative，absolute。
- left和top - 与html中相同，与position relative或absolute一起使用。right和bottom不受支持。
复杂属性
可以通过“attributeName.attributeProperty”或“attributeName-attributeProperty”的标记来设置复杂属性。
例如：border.color="black"或border-color="black"
-
border
- color: 边框颜色
- style: 可能值：solid（实线），dotted（预定义的点线）或由空格分隔的整数形式定义
- type: 显示哪些边缘 - 默认 "top+bottom+left+right"（所有边缘）。"none"值是可能的（它禁用边框）
- size: 边框大小
- radius: 长度单位中的圆角（注意：如果设置了此参数，则type参数将被忽略，圆角边框始终是完整的 - 这将在未来修复）
- position: 边框相对于原始位置的位置。正值扩展边框，负值减少边框。由于此参数的操作，您可以通过添加具有不同样式和位置的另一个边框来获得复杂的边框图案。
-
background
- color: 背景颜色
- image: 背景图像
- repeat: 图像重复的方式（none|x|y|all）
- radius: 长度单位中的背景圆角（目前仅适用于颜色背景）
- use-real-dimension: 仅用于页面（或动态页面）的属性。对于填充也使用边距时为true，否则为false。
- image-width: 背景图像的自定义宽度，允许使用百分比值
- image-height: 背景图像的自定义高度，允许使用百分比值
- position-x: 背景图像的水平位置，允许的值：left，center，right或数值（默认：left）
- position-y: 背景图像的垂直位置，允许的值：top，center，bottom或数值（默认：top）
可以在同一类型中添加多个复杂属性（例如3个不同的边框）。
可以通过使用“stylesheet”标签而不是简写标记来实现这一点。
<pdf> <dynamic-page> <div> <stylesheet> <!-- Top and bootom edges are red, side edges are yellow-gray --> <complex-attribute name="border" color="red" type="top+bottom" /> <complex-attribute id="borderLeftAndRight" name="border" color="yellow" type="left+right" size="4px" /> <complex-attribute id="outerBorderLeftAndRight" name="border" color="gray" type="left+right" size="2px" position="1px" /> </stylesheet> </div> </dynamic-page> </pdf>
在此示例中，第二个边框有一个“borderLeftAndRight”标识符，如果此边框没有标识符，则第二个边框的属性将与第一个边框的属性合并。
请记住，默认标识符“id”与“name”属性相同。复杂属性的“id”属性与标签的“id”属性（用于继承）无关。
可以创建与前面示例相同的复杂边框（outerBorderLeftAndRight）。
单位
支持数值属性的单元
- in（英寸）
- cm（厘米）
- mm（毫米）
- pt（点）
- pc（派卡）*
- px（像素）
-
- %（百分比 - 仅用于宽度和高度）。
目前不支持的单位是：em和ex
当缺少单位时（例如：font-size="10"），则默认单位是点（pt）。1pt = 1/72英寸
条形码
条形码由 <barcode> 标签支持。
PHPPdf 使用 Zend\Barcode 库来生成条形码。
示例
<pdf> <dynamic-page> <barcode type="code128" code="PHPPdf" /> </dynamic-page> </pdf>
<barcode> 标签支持大多数标准属性，并有一些其他属性
- type - 条形码类型，支持值：code128, code25, code25interleaved, code39, ean13, ean2, ean5, ean8, identcode, itf14, leitcode, planet, postnet, royalmail, upca, upce
- draw-code - 与 Zend\Barcode 的 drawCode 选项等价
- bar-height - 与 Zend\Barcode 的 barHeight 选项等价
- with-checksum - 与 Zend\Barcode 的 withChecksum 选项等价
- with-checksum-in-text - 与 Zend\Barcode 的 withChecksumInText 选项等价
- bar-thin-width - 与 Zend\Barcode 的 barThinWidth 选项等价
- bar-thick-width - 与 Zend\Barcode 的 barThickWidth 选项等价
- rotate - 与 Zend\Barcode 的 orientation 选项等价
您可以在 Zend\Barcode 文档 中找到这些选项及其默认值的描述。
为了渲染文本条形码，您不能使用以下嵌入的 PDF 字体：courier, times-roman 和 helvetica。这很快就会得到修复。
图表
PHPPdf 支持绘制简单的图表。
目前仅支持简单的饼图。
示例
<pdf> <dynamic-page> <pie-chart radius="200px" chart-values="10|20|30|40" chart-colors="black|red|green|blue"></pie-chart> </dynamic-page> </pdf>
<pie-chart> 标签有三个额外的属性
- radius - 图表的半径
- chart-values - 图表的值，它们加起来必须等于100。每个值必须用 "|" 分隔。
- chart-colors - 每个值的颜色。每个颜色必须用 "|" 分隔。
超链接
库支持外部和内部超链接。
外部超链接链接到 URL，而内部链接链接到 PDF 文档内的其他标签。
示例
<pdf> <dynamic-page> <a href="http://google.com">go to google.com</a> <br /> <a ref="some-id">go to another tag</a> <a href="#some-id">go to another tag</a> <!-- anchor style ref --> <page-break /> <p id="some-id">Yep, this is another tag! ;)</p> </dynamic-page> </pdf>
每个元素都有一个 "href" 和 "ref" 属性，甚至是 div。您不能在 "a" 标签内嵌套元素。
如果您想将 img 元素用作链接，您应该在 img 标签中直接使用 href（外部链接）或 ref（内部链接）属性。
书签
创建书签的首选方法是使用 "behaviours" 标签。
这不会限制文档的结构，父书签的所有者不一定是子书签所有者的父级。
示例
<pdf> <dynamic-page> <div> <behaviours> <bookmark id="1">parent bookmark</bookmark> </behaviours> Some content </div> <div> <behaviours> <bookmark parentId="1">children bookmark</bookmark> </behaviours> Some another content </div> <div> <behaviours> <bookmark parentId="1">another children bookmark</bookmark> </behaviours> Some another content </div> <div> <behaviours> <bookmark>another parent bookmark</bookmark> </behaviours> Some content </div> </dynamic-page> </pdf>
"bookmark" 行为的快捷方式是 "bookmark" 属性，如果您为此属性分配一些值，则引用此标签的书签将自动创建。
父标签的书签也是子标签书签的父级。
示例
<pdf> <dynamic-page> <div bookmark="parent bookmark"> Some content <div bookmark="children bookmark"> Some another content </div> <div bookmark="another children bookmark"> Some another content </div> </div> <div bookmark="another parent bookmark"> Some content </div> </dynamic-page> </pdf>
上述结构（两个示例）将创建以下书签结构
- 父书签
- 子书签
- 另一个子书签
- 另一个父书签
笔记
可以通过使用 "note" 属性创建便签。
示例
<pdf> <dynamic-page> <div note="note text"></div> </dynamic-page> </pdf>
XML 解析器会规范化属性值，这导致忽略换行符。
如果您想添加包含换行符的便签，您应该使用以下语法
<pdf> <dynamic-page> <div> <behaviours> <note>note text</note> </behaviours> </div> </dynamic-page> </pdf>
可重复的页眉和页脚
"占位符" 可以用来添加可重复的页眉或/和页脚。
某些元素具有特殊的 "占位符"：页面有页眉和页脚，表格也有页眉和页脚（待办事项：尚未实现）等。
<pdf> <dynamic-page> <placeholders> <header> <div height="50px" width="100%"> Header </div> </header> <footer> <div height="50px" width="100%"> Footer </div> </footer> </placeholders> </dynamic-page> </pdf>
页眉和页脚需要设置高度属性。此高度与页面顶部和底部边距一起使用。
工作区是页面大小减去页面边距和占位符（页脚和页眉）高度。
水印
页面可以有一个 "watermark" 占位符。
水印可以设置在块和容器元素上，例如：div、p、h1（不包括span、纯文本或img）。
如果您想使用图像作为水印，应将img标签包裹在div中。
示例
<pdf> <dynamic-page> <placeholders> <watermark> <!-- rotate can have absolute values (45deg - in degrees, 0.123 - in radians) or relative values ("diagonally" and "-diagonally" - angle between diagonal and base side of the page) --> <div rotate="diagonally" alpha="0.1"> <img src="path/to/image.png" /> </div> </watermark> </placeholders> </dynamic-page> </pdf>
页码编号
有两个标签可以用于在页脚、页眉或水印中显示页面信息：page-info和page-number。
此元素仅适用于动态页面，不适用于单页。Page-info显示当前页码和总页码，page-number只显示当前页码。
此标签的属性
- format - 将用作sprintf函数参数的输出字符串的格式。默认值：对于page-number为"%s."，对于page-info为"%s / %s"。
- offset - 将添加到当前页码和总页码的值。如果您想从非零值开始计数页面，则很有用。默认：0。
示例
<pdf> <dynamic-page> <placeholders> <header> <div height="20px"> <page-info format="page %s for %s" /> <!-- when we would like to number from 2 --> <page-info offset="1" format="page %s for %s" /> <!-- when we would like to display only current page number --> <page-info format="%1$s." /> <!-- or --> <page-number /> <!-- when we would like to display only total pages number --> <page-info format="%2$s pages" /> </div> </header> </placeholders> Some text </dynamic-page> </pdf>
使用PDF文档作为模板
"page"和"dynamic-page"标签可以有一个"document-template"属性，允许您使用外部PDF文档作为模板。
对于"page"标签，页面的模板将是外部文档的第一页。
对于"dynamic-page"标签，每页的模板将是外部文档的相应页。
示例
<pdf> <dynamic-page document-template="path/to/file.pdf"> <div>Some content</div> </dynamic-page> </pdf>
分栏的独立页面
页面可以分栏显示
<pdf> <dynamic-page> <column-layout> <div width="100%" height="2500px" background.color="green"> </div> </column-layout> </dynamic-page> </pdf>
上面的XML描述了PDF文档的几页，使用绿色矩形分列。
"column-layout"标签有三个附加参数：number-of-columns、margin-between-columns和equals-columns。
此属性的默认值分别为2、10和false。如果设置了equals-columns属性，则列将具有更多或更少的相等高度。
分页和分栏
可以使用以下标签手动分页和分栏：page-break、column-break、break。
所有这些标签都是相同的。这些标签必须是中断元素的直接子元素（dynamic-page或column-layout）。
如果您想避免在特定标签上自动分页或分栏，应将此标签的"breakable"属性设置为"off"。
示例
<pdf> <dynamic-page> <div breakable="false">this div won't be automatically broken</div> </dynamic-page> </pdf>
元数据
可以在文档的根处通过属性添加元数据。
支持的元数据包括：Creator、Keywords、Subject、Author、Title、ModDate、CreationDate和Trapped。
**这些属性名是区分大小写的。**
示例
<pdf Author="Piotr Sliwa" Title="Test document"> <!-- some other elements --> </pdf>
配置
库有四个主要的配置文件，允许您针对特定需求采用库并进行扩展。
- complex-attributes.xml - 复杂属性类的声明，以逻辑名称标识整个库中的属性。
- nodes.xml - XML文档中允许的标签的定义，包括默认属性和格式化对象。
- fonts.xml - 字体的定义以及将它们分配给标识整个库中的字体的逻辑名称。
- colors.xml - 颜色定义调色板
要更改默认配置文件，必须将配置的Loader对象传递给Facade构造函数。
$loader = new PHPPdf\Core\Configuration\LoaderImpl( '/path/to/file/nodes.xml', '/path/to/file/enhancements.xml', '/path/to/file/fonts.xml', '/path/to/file/colors.xml' ); $facade = new PHPPdf\Core\Facade($loader);
如果您只想更改一个配置文件，应使用LoaderImpl::set*方法。
$loader = new PHPPdf\Core\Configuration\LoaderImpl(); $loader->setFontFile( '/path/to/file/fonts.xml'); //there are setFontFile, setNodeFile, setComplexAttributeFile and setColorFile methods $facade = new PHPPdf\Core\Facade($loader);
FacadeBuilder可用于构建和配置Facade。FacadeBuilder能够配置缓存、渲染引擎和文档解析器。
$builder = PHPPdf\Core\FacadeBuilder::create(/* you can pass specyfic configuration loader object */) ->setCache('File', array('cache_dir' => './cache')) ->setUseCacheForStylesheetConstraint(true); //stylesheets will be also use cache $facade = $builder->build();
Markdown支持
库支持基本的（官方）Markdown语法。要将Markdown文档转换为PDF，您应通过MarkdownDocumentParser配置Facade对象。您还可以使用FacadeBuilder来完成此操作。
示例
$facade = PHPPdf\Core\FacadeBuilder::create() ->setDocumentParserType(PHPPdf\Core\FacadeBuilder::PARSER_MARKDOWN) ->setMarkdownStylesheetFilepath(/** optionaly path to stylesheet in xml format */) ->build();
默认情况下，在Markdown PDF文档中，使用Helvetica字体。如果您想使用UTF-8字符或自定义PDF文档，您应通过使用FacadeBuilder::setMarkdownStylesheetFilepath方法提供自己的样式表。
样式表结构已在样式表章节中描述。默认情况下，样式表为空，如果您想设置另一种字体类型，样式表应如下所示
<stylesheet> <any font-type="DejaVuSans" /> </stylesheet>
内部MarkdownDocumentParser将Markdown文档转换为HTML（通过PHP markdown库），然后转换为XML，最后转换为PDF文档。
请注意，如果在Markdown文档中使用原始HTML，将与PHPPdf的XML语法不兼容（例如，不存在的属性或标签），解析器将抛出异常。
Not all tags used in the markdown implementation are propertly supported by PHPPdf, for example "pre" and "code" tags.
For now "pre" tag is an alias for "div", and "code" tag is an alias for "span", be aware of that.
图片生成引擎
PHPPdf能够生成图像（jpg或png）文件而不是PDF文档。为此，您必须配置FacadeBuilder，例如
$facade = PHPPdf\Core\FacadeBuilder::create() ->setEngineType('image') ->build(); //render method returns array of images' sources, one pdf page is generated to single image file $images = $facade->render(...);
默认情况下，使用GD库渲染图像。
但您也可以使用Imagick，它提供更好的质量，因此如果您有机会在您的服务器上安装Imagick，则推荐使用它。要切换图形库，您必须使用setEngineOptions方法配置FacadeBuilder对象。
$builder = ...; $builder->setEngineOptions(array( 'engine' => 'imagick', 'format' => 'png',//png, jpeg or wbmp 'quality' => 60,//int from 0 to 100 ));
支持的图形库有：GD（默认）、imagick、gmagick。PHPPdf使用Imagine库作为生成图形文件的接口。
已知限制
以下是当前库版本已知限制的列表
- 无法将图像注入到文本中，将在下一个版本中引入
- 对表格元素内的float属性的有限支持（float可能在表格内工作不正确）
- 如果设置了此属性的元素中有多个元素，则vertical-align属性将不正确工作
- 边框不改变元素的尺寸（而在HTML中它们会改变）
- png文件（尤其是未经压缩的文件）效率低下。应使用高压缩（压缩级别6或更高）的png文件或jpeg文件
- 并非所有标签都得到适当的支持，例如，“pre”标签是“div”的别名，“code”标签是“span”的别名
- 线性标签（text、span、code、page-info、page-number、a、b、i、em）的嵌套不支持。如果一个线性标签包含另一个，则只有这些标签内的文本会合并，样式取自最外层的线性标签。
TODO - 计划
- 自动生成“目录”
- 改进表格、表头和页脚，以及表格的rowspan。修复使用colspan时单元格最小高度的计算。
- 支持简单的条形图和饼图
技术要求
此库与PHP 5.3及更高版本兼容。