写在前边的话
使用phpword生成文档有两种方式
- 直接使用代码编写word文档,用代码生成word,但是设置样式,格式,图片非常麻烦,不建议使用。如果客户或产品提供一份word的样式,我们也难以完全复原,调样式很头疼的。
- 读取原有word模板,替换相关变量。个人感觉这种方式能满足绝大部分需求,实现起来也比较简单,所有的样式,格式直接在word模板里设置好,替换变量就可以了,还可以很方便的切换模板。本文主要介绍这种方式,毕竟我们是为了快速实现客户的需求,让客户提供一份word模板,我们稍微一改就可以了。
开始干活
1,通过composer安装phpword包
composer require phpoffice/phpword
2,准备一个word模板(让客户或产品提供吧,docx格式的)
先来一个简单的
这是一个word文档,我们首先要替换的是姓名,电话。现在把这两个值用变量代替,模板里面的变量样式为 ${name} ,如下:
好了,一个简单的模板可以了,就类似于html静态页面
3,开始替换变量(渲染模板)
include_once "vendor/autoload.php";
$tmp=new \PhpOffice\PhpWord\TemplateProcessor('tmp.docx');//打开模板
$tmp->setValue('name','李四');//替换变量name
$tmp->setValue('mobile','18888888888');//替换变量mobile
$tmp->saveAs('简历.docx');//另存为
打开 简历.docx 可以看到变量已经被替换了
OK,流程就是这样,是不是突然觉得导出word很简单?
下面开始一些进阶的功能
如果遇到表格样式的,但又不确定是多少行,如下,教育经历的行数是不确定的
这需要用的克隆行,模板修改如下
这里要记住的是表格左上角的变量school,这个变量用来控制你要复制的是哪一行,复制以后会生成类似于school#1,year#1,school#2,year#2,school#3,year#3 这样的变量
渲染模板
//2复制行
$arr=[
['school'=>'大学','year'=>'2014'],
['school'=>'大学','year'=>'2014'],
['school'=>'大学','year'=>'2014'],
['school'=>'大学','year'=>'2014'],
['school'=>'大学','year'=>'2014'],
['school'=>'大学','year'=>'2014'],
['school'=>'大学','year'=>'2014'],
];
$rows=count($arr);//总行数
$tmp->cloneRow('school',$rows);//复制行
for($i=0;$i<$rows;$i++){
$tmp->setValue("school#".($i+1),$arr[$i]['school']);//替换变量
$tmp->setValue("year#".($i+1),$arr[$i]['year']);
}
结果:
上面是行clone,有时候我们可能要用到块clone,如下面这种情况,如果有获奖记录,我希望显示这一块,如果没有,就整个不显示
这时我们就要加一个块标签了,与html标签格式类似,成对出现,如下图
下面来渲染,当winning有值是显示win_block模块,并渲染winning_record,没有值是不显示win_block模块
$winning_record="";
if($winning_record != ''){
$tmp->cloneBlock('WIN_BLOCK',1);
$tmp->setValue('winning_record',$winning_record);
}else{
#$tmp->deleteBlock('WIN_BLOCK');//这个方法会出错,原因不知,用cloneBlock来代替
$tmp->cloneBlock('WIN_BLOCK',0);
}
结果就不展示了,自己测试一下就可以了,这里的deleteBlock方法不能用,原因我也不知道,我就用cloneBlock复制0行来代替了
替换图片
直接把图片换成变量
渲染
$tmp->setImageValue('header',['path'=>'1.jpeg']);
设置图片宽高
$tmp->setImageValue('header', ['path' => '1.jpg','width'=>500,'height'=>500]);
设置多次替换
$tmp->setImageValue('header', ['path' => '1.jpg','width'=>500,'height'=>500],3);
一些常用的word符号
换行符 <w:br/>
分页符 <w:br w:type="page"/>
制表符 <w:tab/>
html预留字符要替换为实体字符,如&要替换为&
,可以使用htmlspecialchars()
使用方式
比如我们数据库存的换行符一般是 \n\r 这个在word中是无效的,要替换为 <w:br/> 才行
$content = str_replace("\r\n", '<w:br />', $content);
$tem->setValue('content', $content); //内容
本文PHP测试代码gitee
如果有问题,可以留言一起研究学习