# **介绍**

水月居

(本文档基于官方的英文说明文档，因本人专业限制部分文档翻译不太准确，请见谅。欢迎提出宝贵意见！)

### 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)。