# **介绍** 水月居 （本文档基于官方的英文说明文档，因本人专业限制部分文档翻译不太准确，请见谅。欢迎提出宝贵意见！） ### PHPWord是一个用纯PHP编写的库，使用PHPWord可以轻松处理word文档内容，生成你想要的word文档。 他使用非常方便，能生成word（doc,docx）、pdf、rtf、html、odf、odt，xlsx等多种文档格式，且支持对文档类（文字内容、表格、链接、图片、页眉、页脚）各种样式设置。 PHPWord是一个用纯PHP编写的库，它提供了一组用于写入和读取不同文档文件格式的类。当前版本的PHPWord支持Microsoft[Office Open XML](http://en.wikipedia.org/wiki/Office_Open_XML)（OOXML或OpenXML），[Office应用程序的](http://en.wikipedia.org/wiki/OpenDocument)OASIS[Open Document Format](http://en.wikipedia.org/wiki/OpenDocument)（OpenDocument或ODF）和[RTF格式](http://en.wikipedia.org/wiki/Rich_Text_Format)（RTF）。 PHPWord是一个根据[LGPL版本3](https://github.com/PHPOffice/PHPWord/blob/develop/COPYING.LESSER)条款获得许可的开源项目。PHPWord旨在通过整合[持续集成](https://travis-ci.org/PHPOffice/PHPWord)和[单元测试](http://phpoffice.github.io/PHPWord/coverage/develop/)成为高质量的软件产品。您可以通过阅读此开发人员文档和[API文档](http://phpoffice.github.io/PHPWord/docs/develop/)来了解有关PHPWord的更多信息。 ## 功能[](https://phpword.readthedocs.io/en/latest/intro.html#features "永久链接到这个标题") * 设置文档属性，例如标题，主题和创建者。 * 使用不同的设置创建文档部分，例如纵向/横向，页面大小和页面编号 * 为每个部分创建页眉和页脚 * 设置默认字体类型，字体大小和段落样式 * 使用UTF-8和东亚字体/字符 * 将自定义字体样式（例如粗体，斜体，颜色）和段落样式（例如居中，多列，间距）定义为命名样式或文本内联 * 插入段落，可以是包含其他元素的简单文本或复杂文本（文本运行） * 插入标题（标题）和目录 * 插入文本分隔符和分页符 * 插入从右到左的文本 * 插入和格式化图像，本地，远程或页面水印 * 插入二进制OLE对象，如Excel或Visio * 插入并格式化每个行的自定义属性（例如，重复为标题行）和单元格（例如背景颜色，rowspan，colspan） * 将列表项插入项目符号，编号或多级 * 插入超链接 * 插入脚注和尾注 * 插入绘图形状（弧形，曲线，直线，折线，矩形，椭圆形） * 插入图表（饼图，圆环图，条形图，线条图，区域图，散点图，雷达图） * 插入表单字段（textinput，checkbox和dropdown） * 插入评论 * 从模板创建文档 * 使用XSL 1.0样式表来转换OOXML模板的标题，主文档部分和页脚 * ...以及更多有关进展的功能 ## 文件格式[](https://phpword.readthedocs.io/en/latest/intro.html#file-formats "永久链接到这个标题") 以下是每种文件格式支持的功能。 ### 写入[](https://phpword.readthedocs.io/en/latest/intro.html#writers "永久链接到这个标题") | 特征 |   | OOXML | ODF | RTF | HTML | PDF | | --- | --- | --- | --- | --- | --- | --- | | **文档属性** | 标准 | ✓ | ✓ | ✓ | ✓ | ✓ | |   | 习惯 | ✓ | ✓ |   |   |   | | **元素类型** | 文本 | ✓ | ✓ | ✓ | ✓ | ✓ | |   | 文字运行 | ✓ | ✓ | ✓ | ✓ | ✓ | |   | 标题 | ✓ | ✓ |   | ✓ | ✓ | |   | 链接 | ✓ | ✓ | ✓ | ✓ | ✓ | |   | 保留文字 | ✓ |   |   |   |   | |   | 文字休息 | ✓ | ✓ | ✓ | ✓ | ✓ | |   | 分页符 | ✓ |   | ✓ |   |   | |   | 名单 | ✓ |   |   |   |   | |   | 表 | ✓ | ✓ | ✓ | ✓ | ✓ | |   | 图片 | ✓ | ✓ | ✓ | ✓ |   | |   | 宾语 | ✓ |   |   |   |   | |   | 水印 | ✓ |   |   |   |   | |   | 目录 | ✓ |   |   |   |   | |   | 头 | ✓ |   |   |   |   | |   | 页脚 | ✓ |   |   |   |   | |   | 脚注 | ✓ |   |   | ✓ |   | |   | 尾注 | ✓ |   |   | ✓ |   | |   | 评论 | ✓ |   |   |   |   | | **图表** | 2D基本图表 | ✓ |   |   |   |   | |   | 2D高级图 |   |   |   |   |   | |   | 三维图 | ✓ |   |   |   |   | | **数学** | OMML支持 |   |   |   |   |   | |   | MathML支持 |   |   |   |   |   | | **奖金** | 加密 |   |   |   |   |   | |   | 保护 |   |   |   |   |   | ### 读取[](https://phpword.readthedocs.io/en/latest/intro.html#readers "永久链接到这个标题") | 特征 |   | OOXML | DOC | ODF | RTF | HTML | | --- | --- | --- | --- | --- | --- | --- | | **文档属性** | 标准 | ✓ |   |   |   |   | |   | 习惯 | ✓ |   |   |   |   | | **元素类型** | 文本 | ✓ | ✓ | ✓ | ✓ | ✓ | |   | 文字运行 | ✓ |   |   |   |   | |   | 标题 | ✓ |   | ✓ |   |   | |   | 链接 | ✓ | ✓ |   |   |   | |   | 保留文字 | ✓ |   |   |   |   | |   | 文字休息 | ✓ | ✓ |   |   |   | |   | 分页符 | ✓ |   |   |   |   | |   | 名单 | ✓ |   | ✓ |   | ✓ | |   | 表 | ✓ |   |   |   | ✓ | |   | 图片 | ✓ | ✓ |   |   |   | |   | 宾语 |   |   |   |   |   | |   | 水印 |   |   |   |   |   | |   | 目录 |   |   |   |   |   | |   | 头 | ✓ |   |   |   |   | |   | 页脚 | ✓ |   |   |   |   | |   | 脚注 | ✓ |   |   |   |   | |   | 尾注 | ✓ |   |   |   |   | |   | 评论 |   |   |   |   |   | | **图表** | 2D基本图表 |   |   |   |   |   | |   | 2D高级图 |   |   |   |   |   | |   | 三维图 |   |   |   |   |   | | **数学** | OMML支持 |   |   |   |   |   | |   | MathML支持 |   |   |   |   |   | | **奖金** | 加密 |   |   |   |   |   | |   | 保护 |   |   |   |   |   | ## 贡献[](https://phpword.readthedocs.io/en/latest/intro.html#contributing "永久链接到这个标题") 我们欢迎大家为PHPWord做出贡献。以下是您可以做的一些贡献。 * 阅读[我们的贡献指南](https://github.com/PHPOffice/PHPWord/blob/master/CONTRIBUTING.md)。 * [叉我们](https://github.com/PHPOffice/PHPWord/fork)并[要求拉](https://github.com/PHPOffice/PHPWord/pulls)来的[发展](https://github.com/PHPOffice/PHPWord/tree/develop)分支。 * 将[错误报告或功能请求](https://github.com/PHPOffice/PHPWord/issues)提交给GitHub。 * 在Twitter上关注[@PHPWord](https://twitter.com/PHPWord)和[@PHPOffice](https://twitter.com/PHPOffice)。