PHPWord中文手册整理

摘要：修正中文支持的问题，使用前如果发现乱码，需要进行一些修正解决编码问题，会对输入的文字进行编码转化，如果你使用或者编码的话就会出现乱码，如果你用编码，就查找类库中所有方法中的转码将其删除，如果你采用或者编码，使用进行编码转换。

中文支持的问题，使用前如果发现乱码，需要进行一些修正：

解决编码问题，PHPword 会对输入的文字进行utf8_encode编码转化，如果你使用GBK、GB2312或者utf8编码的话就会出现乱码，如果你用utf8编码，就查找类库中所有方法中的 utf8_encode 转码将其删除，如果你采用GBK或者GB2312编码，使用iconv进行编码转换。

解决中文字体支持，在writer/word2007/base.php中 312行添加 $objWriter->writeAttribute("w:eastAsia",$font)

启动php zip支持，windows环境下在php配置文件php.ini中，将extension=php_zip.dll前面的分号“;”去除；(如果没有，请添加extension=php_zip.dll此行并确保php_zip.dll文件存在相应的目录)，然后同样在php.ini文件中，将 zlib.output_compression = Off 改为zlib.output_compression = On ； 

PHPWord最基本的计量单位：“缇”（twips），我们常常在文件中看到或使用计量单位“缇”，它是开源办公软件中最基本的计量单位，“缇”是"TWentieth of an Inch Point"的简写，意思 1/20磅，与其他常用剂量单位的换算是1缇=1/1，440英寸
1缇=1/567厘米
1缇=1/15像素

文档默认字体是Arial，字号10号，我们可以通过以下方法设置默认字体和字号：
注，该库存在中文字体支持问题，解决方法：见文档开头

$PHPWord->setDefaultFontName("Tahoma");
$PHPWord->setDefaultFontSize(12);

我们可以设置下列文档属性

我们可以通过以下方法设置文档属性

$properties = $PHPWord->getProperties();
$properties->setCreator("My name"); 
$properties->setCompany("My factory");
$properties->setTitle("My title");
$properties->setDescription("My description"); 
$properties->setCategory("My category");
$properties->setLastModifiedBy("My name");
$properties->setCreated( mktime(0, 0, 0, 3, 12, 2010) );
$properties->setModified( mktime(0, 0, 0, 3, 14, 2010) );
$properties->setSubject("My subject"); 
$properties->setKeywords("my, key, word");

添加默认页面（默认页面方向和页边距）：

$section = $PHPWord->createSection();

调整页面样式和布局有两种方法：
1.创建样式数组:

$sectionStyle = array("orientation" => null,
       "marginLeft" => 900,
       "marginRight" => 900,
       "marginTop" => 900,
       "marginBottom" => 900);
$section = $PHPWord->createSection($sectionStyle);

2.直接调用样式属性设置方法进行设置:

$section = $PHPWord->createSection();
$sectionStyle = $section->getSettings();
$sectionStyle->setLandscape();
$sectionStyle->setPortrait();
$sectionStyle->setMarginLeft(900);
$sectionStyle->setMarginRight(900);
$sectionStyle->setMarginTop(900);
$sectionStyle->setMarginBottom(900);

注意：所有的属性对大小写敏感 !

页面高度和宽度是自动设置的，你可以通过以下两个属性来修改，但不推荐进行修改。

向文档添加文本使用方法函数： addText.（注意PHPword 会对输入的文字进行utf8_encode编码转化，如果你使用GBK、GB2312或者utf8编码的话就会出现乱码，如果你用utf8编码，就查找类库中所有方法中的 utf8_encode 转码将其删除，如果你采用GBK或者GB2312编码，使用iconv进行编码转换。）

$section->addText( $text, [$fontStyle], [$paragraphStyle] );

文本资源可以包含文本和链接，可以统一赋予段落样式，添加文本资源使用函数方法createTextrun.

添加文本资源后，就可以添加具有独特样式的文本或链接了。

$textrun = $section->createTextRun();
$textrun->addText("I am bold", array("bold"=>true)); 
$textrun->addText("I am italic, array("italic"=>true));
$textrun->addText("I am colored, array("color"=>"AACC00"));

当然也可以继承使用段落或文字样式

设置文本样式有两种方法：
1.内嵌样式：

$fontStyle = array("color"=>"006699", "size"=>18, "bold"=>true);
$section->addText("helloWorld", $fontStyle);

$text = $section->addText("helloWorld");
$style = $text->getStyle();
$style->setColor("006699");
$style->setSize(18);
$style->setBold();

2.或者定义一个样式定义设置文本样式，定义一种样式后，必须把第二个参数设置为样式名称，使用方法函数addFontStyle:

$PHPWord->addFontStyle( $styleName, $fontStyle);

示例：

$fontStyle = array("color"=>"006699", "size"=>18, "bold"=>true);
$PHPWord->addFontStyle("myOwnStyle", $fontStyle);
$text = $section->addText("helloWorld", "myOwnStyle");

添加段落样式，使用方法函数addParagraphStyle:

属性大小写敏感 !

添加换行符，使用方法函数 addTextBreak:

$section->addTextBreak();

添加多个换行符：

$section->addTextBreak(15);

添加分页符，使用方法函数：addPageBreak:

$section->addPageBreak();

添加列表使用方法函数： addListItem:

$section->addListItem( $text, [$depth], [$styleText], [$styleList], [$styleParagraph] );

示例:

$listStyle = array("listType" => PHPWord_Style_ListItem::TYPE_NUMBER);
$section->addListItem("Listitem 1", 0, null, $listStyle);

属性大小写敏感!

添加超链接，使用方法函数： addLink:

$section->addLink( $linkSrc, [$linkName], [$styleFont], [$styleParagraph]);

注意在添加链接地址时最好trim一下前后有空格很可有可能导致文档打不开

定义超链接风格的两种方法

内嵌样式:

$linkStyle = array("color"=>"0000FF",
    "underline"=>PHPWord_Style_Font::UNDERLINE_SINGLE);
$section->addLink("http://www.google.de", null, $linkStyle);

或者定义一个样式定义设置超链接样式，定义一种样式后，必须把第三个参数设置为样式名称

$linkStyle = array("color"=>"0000FF",
    "underline"=>PHPWord_Style_Font::UNDERLINE_SINGLE);
$PHPWord->addLinkStyle("myHyperlinkStyle", $linkStyle);
$section->addLink("http://www.google.de", null, "myHyperlinkStyle");

添加图片的函数方法： addImage:

$section->addImage( $src, [$style] );

注意在添加图片路径时最好trim一下前后有空格很可有可能导致文档打不开

添加图片样式只能使用数组方式 :

$imageStyle = array("width"=>350, "height"=>350, "align"=>"center");
$section->addImage("EARTH.jpg", $imageStyle);

大小写敏感!

如果没有指定图片高或宽的属性，系统将使用PHP原生函数”getimagesize”来获取相关属性。
PHPWord 支持的图片格式: gif, jpeg, png, bmp, tiff.

你也可以添加由GD库生成的图片，使用函数方法：addMemoryImage:

$section->addMemoryImage( $link, [$style] );

示例:

$section->addMemoryImage("http://localhost/image.php");

你GD图片样式的设置和本地图片一样.

PHPWord 支持的 GD 图片类型： png, jpeg, gif.

添加水印的页面需要一个头部引用，添加水印方法函数：addWatermark

水印图片是在页面是绝对定位的，所以水印图片至少需要两个样式属性

注：图片样式并没有提供图像并排，文字环绕等功能，可以通过与表格想结合进行解决。

我们可以使用方法函数 addObject，添加对象和链接

$section->addObject( $src, [$style] );

对象属性是有一个样式:
属性区分大小写!

PHPWord 支持的对象类型： XLS, DOC, PPT.

我们可以使用标题来为结构化文档或为文档建立目录，添加标题使用方法函数addTitleStyle 和 addTitle:

$PHPWord->addTitleStyle( $titleCount, [$fontStyle] );

需要添给标题添加一个样式，否则文档不会将其作为一个真正的标题来处理。

定义标题样式后，定义标题就很简单了，可以使用函数方法：addTitle;

$section->addTitle( $text, [$depth] );

添加目录使用方法函数： addTOC:

$styleTOC = array("tabLeader"=>PHPWord_Style_TOC::TABLEADER_DOT);
$styleFont = array("spaceAfter"=>60, "name"=>"Tahoma", "size"=>12);
$section->addTOC($styleFont, $styleTOC);

样式属性区分大小写 !

添加表格使用函数方法：addTable:

$table = $section->addTable( [$tableStyle] );

参数 $tableStyle 是可选的. 表格样式这章有关于表格样式的详细说明。为addTable建立一个本地对象，我们需要使用这个对象来调用相关函数方法。

添加行

$table->addRow( [$height] );

行的高度可以通过$height参数来设置，单位：twips.

添加单元格

单元格添加前必须先添加行，添加单元格的函数方法为： addCell

$cell = $table->addCell(h, [$cellStyle] );

为addcell创建一个本地对象，需要使用该对象来 调用以下函数

示例1:

$table = $section->addTable();
$table->addRow();
$cell = $table->addCell(2000);
$cell->addText("Cell 1");
$cell = $table->addCell(2000);
$cell->addText("Cell 2");
$cell = $table->addCell(2000);
$cell->addText("Cell 3");

示例2:

$table = $section->addTable();
$table->addRow(400);
$table->addCell(2000)->addText("Cell 1");
$table->addCell(2000)->addText("Cell 2");
$table->addCell(2000)->addText("Cell 3");

$table->addRow(1000);
$table->addCell(2000)->addText("Cell 4");
$table->addCell(2000)->addText("Cell 5");
$table->addCell(2000)->addText("Cell 6");

使用addCell的第二个参数来给单元格设置样式
示例:

$cellStyle = array("textDirection"=>PHPWord_Style_Cell::TEXT_DIR_BTLR,     "bgColor"=>"C0C0C0");

$table = $section->addTable();
$table->addRow(1000);
$table->addCell(2000, $cellStyle)->addText("Cell 1");
$table->addCell(2000, $cellStyle)->addText("Cell 2");
$table->addCell(2000, $cellStyle)->addText("Cell 3");
$table->addRow();
$table->addCell(2000)->addText("Cell 4");
$table->addCell(2000)->addText("Cell 5");
$table->addCell(2000)->addText("Cell 6");

属性大小写敏感 !

我们可以设置整个表格的样式，通过创建表格函数addTable的参数$tableStyle，表格具有如下样式属性
属性名称大小写敏感!

示例:

$tableStyle = array("cellMarginTop"=>80,
     "cellMarginLeft"=>80,
     "cellMarginRight"=>80,
     "cellMarginBottom"=>80);
$table = $section->addTable($tableStyle);

我们可以使用函数方法： addTableStyle，为表格定义一个完整的样式。

$PHPWord->addTableStyle($styleName,  $styleTable, [$styleFirstRow] );

示例:

$styleTable = array("borderColor"=>"006699",
     "borderSize"=>6,
     "cellMargin"=>50);
$styleFirstRow = array("bgColor"=>"66BBFF");
$PHPWord->addTableStyle("myTable", $styleTable, $styleFirstRow);

$table = $section->addTable("myTable");
$table->addRow(400);
$table->addCell(2000)->addText("Cell 1");
$table->addCell(2000)->addText("Cell 2");
$table->addCell(2000)->addText("Cell 3");
$table->addRow(1000);
$table->addCell(2000)->addText("Cell 4");
$table->addCell(2000)->addText("Cell 5");
$table->addCell(2000)->addText("Cell 6");

表格样式属性，注意属性名称大小写敏感!

注意：表格在word布局中的功能可以进行体现，例如进行图片，对象等的布局可以考虑与表格结合进行处理

$footer = $section->createFooter();

确保在本地对象中保存页脚，并使用下列函数

addPreserveText( $text, [$style] );

示例:

$footer->addPreserveText("Page {PAGE} of {NUMPAGES}.");

$header = $section->createHeader();

确保页眉是建立在一个文档中，页眉和页脚使用相同的属性和函数，详见页脚章节 。
注意：只用添加了页眉的页面，才能添加和使用图片水印

我们可以利用搜索替换功能创建一个docx格式的模版文档，来替换文档中你想替换的文本. 但是要注意，只有文本或链接可以被替换。加载模版文档使用函数方法：loadTemplate function.

加载完成模版文档后，你可以使用函数方法： setValue 来搜索替换相关内容

$template = $PHPWord->loadTemplate("Template.docx");
$template->setValue("Name", "Somebody someone");
$template->setValue("Street", "Coming-Undone-Street 32");

被搜索替换的标签格式为： ${YOUR_SEARCH_PATTERN}
不能添加新的PHPWORD元素到加载的模版文档中
模版使用的几个注意事项：

从模板生成word文档，支持在word模板文档里写替换标签，标签格式为${xxx}，不过一定要注意，不要直接在word里编辑这些标签，一定要在文本文档里先写好标签，直接拷贝粘贴上去，千万不要编辑，否则无法替换，原因也很简单，把word文档另存为xml，然后看xml里标签的位置，会发现标签中间被插入了很多没用的xml节点，还有中文字体的节点。。。

模版文档要一次性完成在保存，否则会出现替换失败问题。

中文乱码问题，这个一定是存在的，如果php环境已经是utf8了，要找到关键地方，转utf8的代码，去掉，否则就是转两次编码了，典型的是phpwordtemplate.php文件，把这行注释掉：$replace = utf8_encode($replace);

linux下报“Could not close zip file.”错误，这个你永远想不到，要将模板文件所在目录权限改为可写，因为要在那个目录下生成临时文件

引用模板文件和另存文件路径什么的，最好用绝对路径

声明：本文内容来自网络文件，部分未测试，后面有机会整个实例出来，目前整理成一份适合在网页阅读的文档，供参考。
官方实例：https://github.com/PHPOffice/...
官网：https://phpword.readthedocs.i...