1
php 中文网(www.php.cn)
PHPWord Beta 0.6.2
开发者指南
2
目 录
首先我们要了解文档最基本的信息和设置:........................................................................4
计量单位:缇(twips) .........................................................................................................4
字体设置 ...................................................................................................................................4
文档属性设置 ...........................................................................................................................4
新建文档 ...................................................................................................................................5
添加页面 ...............................................................................................................................5
页面样式 ...............................................................................................................................5
页面样式属性 .......................................................................................................................6
文本 ...........................................................................................................................................7
添加文本 ...............................................................................................................................7
添加文本资源 .......................................................................................................................7
文本样式 ...............................................................................................................................8
样式属性列表 .......................................................................................................................9
添加换行符 .........................................................................................................................10
添加分页符 .............................................................................................................................10
列表 .........................................................................................................................................10
添加列表 .............................................................................................................................10
列表样式 .............................................................................................................................11
列表样式属性列表 .............................................................................................................11
超链接 .....................................................................................................................................11
添加超链接 .........................................................................................................................11
超链接样式 .........................................................................................................................12
图片 .........................................................................................................................................13
添加图片 .............................................................................................................................13
图片样式 .............................................................................................................................13
图片样式属性 .....................................................................................................................13
添加 GD 生成图片 ...............................................................................................................14
添加水印 .............................................................................................................................14
添加对象 .................................................................................................................................15
添加标题 .................................................................................................................................15
添加目录 .................................................................................................................................16
3
表格 .........................................................................................................................................17
添加表格 .............................................................................................................................17
添加行 .............................................................................................................................17
添加单元格 .....................................................................................................................17
单元格样式 .........................................................................................................................19
表格样式 .............................................................................................................................20
页脚 .........................................................................................................................................22
页眉 .........................................................................................................................................23
模版 .........................................................................................................................................23
其他问题修改 .........................................................................................................................25
解决文本缩进问题 .............................................................................................................25
表格对齐和表格缩进 .........................................................................................................27
图片缩进和绝对相对悬浮定位..........................................................................................30
4
首先我们要了解文档最基本的信息和设置:
因为是国外编辑的类库,存在对中文支持的问题,使用前,我们需要
进行一些修正:
1、解决编码问题,PHPword 会对输入的文字进行 utf8_encode 编码
转化,如果你使用 GBK、GB2312 或者 utf8 编码的话就会出现乱码,如果
你用 utf8 编码,就查找类库中所有方法中的 utf8_encode 转码将其删
除,如果你采用 GBK 或者 GB2312 编码,使用 iconv 进行编码转换。
2、解决中文字体支持,在 writer/word2007/base.php 中 312 行添
加 $objWriter->writeAttribute('w:eastAsia',$font)
3、启动 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 ;
计量单位:缇(twips)
首先解释一下 PHPWord 最基本的计量单位:“缇”(twips),我们
常常在文件中看到或使用计量单位“缇”,它是开源办公软件中最基本的
计量单位,“缇”是"TWentieth of an Inch Point"的简写,意思 1/20
磅,与其他常用剂量单位的换算是 1 缇=1/1,440 英寸,1 缇=1/567 厘米,
1 缇=1/15 像素
字体设置
文档默认字体是 Arial,字号 10 号,我们可以通过以下方法设置默认
字体和字号:
注,该库存在中文字体支持问题,解决方法:见文档开头
$PHPWord->setDefaultFontName('Tahoma');
5
$PHPWord->setDefaultFontSize(12);
文档属性设置
我们可以设置下列文档属性
名称
类型
描述
Creator
String
创建者
Company
String
公司
Title
String
标题
Description
String
描述
Category
String
分类
Last
modified by
String
最后修改者
Created
Datetime
创建时间
Modified
Datetime
修改时间
Subject
String
主题
Keywords
String
关键词
我们可以通过以下方法设置文档属性
$properties = $PHPWord->getProperties();
$properties->setCreator('My name');
$properties->setCompany('My factory');
$properties->setTitle('My title');