PHP使用phpword生成word文档

写在前边的话

使用phpword生成文档有两种方式

• 直接使用代码编写word文档，用代码生成word，但是设置样式，格式，图片非常麻烦，不建议使用。如果客户或产品提供一份word的样式，我们也难以完全复原，调样式很头疼的。
• 读取原有word模板，替换相关变量。个人感觉这种方式能满足绝大部分需求，实现起来也比较简单，所有的样式，格式直接在word模板里设置好，替换变量就可以了，还可以很方便的切换模板。本文主要介绍这种方式，毕竟我们是为了快速实现客户的需求，让客户提供一份word模板，我们稍微一改就可以了。

开始干活

1，通过composer安装phpword包

composer require phpoffice/phpword

2，准备一个word模板(让客户或产品提供吧，docx格式的)

先来一个简单的

1.png

这是一个word文档，我们首先要替换的是姓名，电话。现在把这两个值用变量代替，模板里面的变量样式为 ${name} ,如下：

2.png

好了，一个简单的模板可以了，就类似于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 可以看到变量已经被替换了

3.png

OK,流程就是这样，是不是突然觉得导出word很简单？

---

下面开始一些进阶的功能
如果遇到表格样式的，但又不确定是多少行，如下，教育经历的行数是不确定的

4.png

这需要用的克隆行，模板修改如下

5.png

这里要记住的是表格左上角的变量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']);
}

结果：

5.png

---

上面是行clone，有时候我们可能要用到块clone,如下面这种情况，如果有获奖记录，我希望显示这一块，如果没有，就整个不显示

6.png

这时我们就要加一个块标签了，与html标签格式类似,成对出现，如下图

7.png

下面来渲染，当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行来代替了

---

替换图片

img1.png

直接把图片换成变量

2.png

渲染

$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符号

换行符
分页符
制表符
html预留字符要替换为实体字符，如&要替换为&，可以使用htmlspecialchars()
使用方式
比如我们数据库存的换行符一般是 \n\r 这个在word中是无效的，要替换为 才行

$content = str_replace("\r\n", '', $content);
$tem->setValue('content', $content); //内容

本文PHP测试代码gitee
如果有问题，可以留言一起研究学习