因为最近项目需要一个生成Word文档的功能,开始折腾起来,找到PhoWord这个类库,PhpWord是一个可以用PHP生成word的类库,用composer安装就可以用了。
搞了半天,终于生成了Word文档,现在来记录一下一些用法供大家参考。
PhpWord文档
想实现更多功能的同学可以仔细参考文档
https://phpword.readthedocs.io/en/latest/intro.html
使用环境
目前是在ThinkPHP5.0.21中使用的PhpWord,其他使用环境引入方式可能会有一点不同。
使用composer安装,直接使用下面的代码引入相关类库
安装
1、打开命令行进入项目根目录执行下面命令
2、composer require phpoffice/phpword
使用模式
1、直接使用代码编写word文档
2、读取原有word模板,替换相关变量
模板生成Word
使用场景:适合有一套固定的模板,只有几个关键的地方需要改变。
使用方式:下面介绍几行代码就足够完成整个word的替换了,需要更多功能参考文档。
//模板的路径,word的版本最好是docx,要不然可能会读取不了,根据自己的模板位置调整$path = 'public/letters/templates/word/letter1.docx';//生成word路径,根据自己的目录调整$filePath= 'public/letters/word/letter1.docx';//声明一个模板对象、读取模板$templateProcessor = new \PhpOffice\PhpWord\TemplateProcessor($path);//替换模板中的变量,对应word里的 ${test}$test ="这是替换的内容";$templateProcessor->setValue('test',$test);//传真//生成新的word$templateProcessor->saveAs($filePath);
代码编写Word
使用场景:需要更加灵活的生成Word
语法介绍:介绍一些常用的、需要的功能,多余的也不介绍了,来些直观的才是重要的,需要更多功能参考文档。
//声明一个phpword对象$phpWord = new \PhpOffice\PhpWord\PhpWord();//声明一个页面,用来存放页面的内容,相当于一个容器$section = $phpWord->addSection();//添加一个段落文字$section->addText('This is text');//声明普通文字,不同段落文字,可以在后面追加文字$textrun = $section->addTextRun();//添加文字$textrun->addText('This ');//再上面内容的后面追加文字$textrun->addText('is');//文字换行,参数可以控制换行的行数$textrun->addTextBreak(1);//段落文字换行,参数可以控制换行的行数$section->addTextBreak(1);//文字样式,可以指定许多样式,具体可以参考文档字体样式$textrun->addText('测试',array('size'=>18,'bold'=>true,'name'=>'宋体'));//可以定义一个数组传进去,本质都是一个数组$fontStyle['size']=12;$fontStyle['bold']=true;$textrun->addText('测试',$fontStyle);//生成Word文档$filePath= 'public/letters/word/letter1.docx';$objWriter = \PhpOffice\PhpWord\IOFactory::createWriter($phpWord, 'Word2007');$objWriter->save($filePath);
PS:
1、Phpword虽然可以用代码生成word,但对于一些文字图片的定位操控起来非常麻烦,甚至无法控制。
2、尽量使用模板,直接改动模板更加方便,只替换一些关键字就好。
3、使用模板的时候要注意word格式要是docx,使用doc可能会报错。
结语
以上是自己这几天使用Phpword小小心得,希望大家少走弯路吧,也给自己以后再使用时可以温习下,如有不正确之处,还望指出。