README
分支 Master :
PHPWord 是一个用纯PHP编写的库，提供了一系列类来写入和读取不同的文档文件格式。PHPWord 当前版本支持 Microsoft Office Open XML（OOXML 或 OpenXML）、OASIS Open Document Format for Office Applications（OpenDocument 或 ODF）、Rich Text Format（RTF）、HTML 和 PDF。
PHPWord 是一个开源项目，根据 LGPL 版本 3 许可协议发布。PHPWord 通过整合持续集成和单元测试，旨在成为一个高质量的软件产品。您可以通过阅读 开发者文档 来了解更多关于 PHPWord 的信息。
如果您有任何问题，请在 StackOverFlow 上提问。
了解更多关于 PHPWord
功能
需求
安装
入门
贡献
开发者文档
功能
使用 PHPWord，您可以使用 PHP 脚本动态创建 OOXML、ODF 或 RTF 文档。以下是您可以使用 PHPWord 库执行的一些操作：
设置文档属性，例如标题、主题和创建者。
创建具有不同设置的文档部分，例如纵向/横向、页面大小和页码。
为每个部分创建页眉和页脚。
设置默认字体类型、字体大小和段落样式。
使用 UTF-8 和东亚字体/字符。
定义自定义字体样式（例如粗体、斜体、颜色）和段落样式（例如居中、多栏、间距），无论是命名样式还是文本中的内联样式。
插入段落，可以是简单文本或复杂文本（文本运行），其中包含其他元素。
插入标题（页眉）和目录。
插入文本中断和分页符。
插入和格式化图像，本地、远程或作为页面水印。
插入二进制 OLE 对象，如 Excel 或 Visio。
插入和格式化表格，具有为每行（例如重复作为标题行）和单元格（例如背景颜色、跨行、跨列）定制的属性。
插入列表项，可以是项目符号、编号或多层次。
插入超链接。
插入脚注和尾注。
插入绘图形状（弧线、曲线、线条、多段线、矩形、椭圆）。
插入图表（饼图、环形图、柱状图、折线图、面积图、散点图、雷达图）。
插入表单字段（文本输入、复选框和下拉列表）。
从模板创建文档。
使用 XSL 1.0 样式表转换 OOXML 模板的页眉、主文档部分和页脚。
... 以及更多正在开发的功能
需求
PHPWord 需要以下条件：
PHP 7.1+
XML 解析器扩展
Laminas Escaper 组件
Zip 扩展（可选，用于写入 OOXML 和 ODF）
GD 扩展（可选，用于添加图片）
XMLWriter 扩展（可选，用于写入 OOXML 和 ODF）
XSL 扩展（可选，用于将 XSL 样式表应用于模板）
dompdf 库（可选，用于写入 PDF）
安装
PHPWord 通过 Composer 安装。要将 PHPWord 添加到项目的依赖项中，可以
运行以下命令以使用最新稳定版本
composer require phpoffice/phpword
或者如果您想要最新的未发布版本
composer require phpoffice/phpword:dev-master
入门
以下是 PHPWord 库的基本使用示例。
require_once 'bootstrap.php';
// Creating the new document...
$phpWord = new \PhpOffice\PhpWord\PhpWord();
/* Note: any element you append to a document must reside inside of a Section. */
// Adding an empty Section to the document...
$section = $phpWord->addSection();
// Adding Text element to the Section having font styled by default...
$section->addText(
'"Learn from yesterday, live for today, hope for tomorrow. '
. 'The important thing is not to stop questioning." '
. '(Albert Einstein)'
);
/*
* Note: it's possible to customize font style of the Text element you add in three ways:
* - inline;
* - using named font style (new font style object will be implicitly created);
* - using explicitly created font style object.
*/
// Adding Text element with font customized inline...
$section->addText(
'"Great achievement is usually born of great sacrifice, '
. 'and is never the result of selfishness." '
. '(Napoleon Hill)',
array('name' => 'Tahoma', 'size' => 10)
);
// Adding Text element with font customized using named font style...
$fontStyleName = 'oneUserDefinedStyle';
$phpWord->addFontStyle(
$fontStyleName,
array('name' => 'Tahoma', 'size' => 10, 'color' => '1B2232', 'bold' => true)
);
$section->addText(
'"The greatest accomplishment is not in never falling, '
. 'but in rising again after you fall." '
. '(Vince Lombardi)',
$fontStyleName
);
// Adding Text element with font customized using explicitly created font style object...
$fontStyle = new \PhpOffice\PhpWord\Style\Font();
$fontStyle->setBold(true);
$fontStyle->setName('Tahoma');
$fontStyle->setSize(13);
$myTextElement = $section->addText('"Believe you can and you\'re halfway there." (Theodor Roosevelt)');
$myTextElement->setFontStyle($fontStyle);
// Saving the document as OOXML file...
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');
$objWriter->save('helloWorld.docx');
// Saving the document as ODF file...
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'ODText');
$objWriter->save('helloWorld.odt');
// Saving the document as HTML file...
$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'HTML');
$objWriter->save('helloWorld.html');
/* Note: we skip RTF, because it's not XML-based and requires a different example. */
/* Note: we skip PDF, because "HTML-to-PDF" approach is used to create PDF documents. */
更多示例在 示例文件夹 中提供。要方便地访问这些示例，在示例目录中运行 php -S localhost:8000，然后在浏览器中浏览到 https://:8000 以查看示例。您还可以阅读 开发者文档 以获取更多详细信息。
贡献
我们欢迎每个人为 PHPWord 做出贡献。以下是一些您可以做出的贡献。
阅读 我们的贡献指南。
Fork 我们 并向 master 分支请求合并。
向 GitHub 提交 错误报告或功能请求。
关注 @PHPOffice 在 Twitter 上的动态。