# **介紹**
水月居
(本文檔基于官方的英文說明文檔,因本人專業限制部分文檔翻譯不太準確,請見諒。歡迎提出寶貴意見!)
### 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)。