PHPWord利用模板替换字符串生成精确的word文档

phpword处理docx模板时候始终发生神奇的BUG,就是复制原版例子里的${Value1}进自己的模板然后替换是没问题的,但是只要一改动这个变量文字,PHP做相应替换就失效了。

用了下残废百度无果,一怒翻起google,准确度高多了。

   原来有2个PHPWord项目:

其中适用比较广的是PHPOffice项目下的一个子项目

Git地址:https://github.com/PHPOffice/PHPWord

查看官方的文档:

http://phpword.readthedocs.org/en/latest/templates-processing.html?highlight=replace

具体如何用模板做替换:

[php]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. include_once ('exec/lib/phpword/src/PhpWord/PHPWord.php');  
  2. use PhpOffice\PhpWord\Autoloader;  
  3. use PhpOffice\PhpWord\Settings;  
  4. use PhpOffice\PhpWord\IOFactory;  
  5.   
  6. include_once ('exec/lib/phpword/src/PhpWord/Autoloader.php');  
  7. Autoloader::register();  
  8. Settings::loadConfig();  
  9.   
  10. // Create a new PHPWord Object  
  11. $PHPWord = new \PhpOffice\PhpWord\PhpWord();  
  12. $templateProcessor = new \PhpOffice\PhpWord\TemplateProcessor('statics/template/adminPositive.docx');  
  13. $templateProcessor->setValue('xm1''姓名');  
  14. $templateProcessor->setValue('zw1''公务员');  
  15. $templateProcessor->setValue('sfz1''360281199909090009');  
  16. $templateProcessor->setValue('gz1''统发');  
  17. //$templateProcessor->setValue('Street', 'Coming-Undone-Street 32');  
  18. $templateProcessor->saveAs('test.docx');  

这里要注意的是换行问题。


另外copy一篇比较nice的博文做个备份

转载自:http://wangye.org/blog/archives/943/

===============================================================================================

最近一个项目开发要用到PHP技术导出Word文档,比较了几种方案,首先是使用Microsoft Office自带的ActiveX/COM组件,比如Word.Application,这种方式的优点是格式兼容度高,可以生成纯doc的Word2003格式文档,缺点一是比较占资源(调用会启动一个WINWORD.EXE进程),不适合Web多用户访问使用;二是PHP这种Web开发技术大多数是跑在Linux服务器上,当然也就无法使用Windows下的技术了,平台可移植和兼容性不好。第二种生成Word的方案是生成Word兼容的网页格式,然后以Word方式打开,这种方案总体上感觉怪怪的,毕竟文件格式是HTML的,而且格式兼容度不好,不过这种方式的优点是节省服务器资源,能够快速生成;最后一种方案也就是今天的主角,采用PHPWord生成Word2007(docx)格式的文档,现在基本上微软Office Word 2003以后的版本均兼容这种格式了,对于2003版本来说,仅需要下载安装个兼容格式包(下载地址),也能正常打开这类文件,当然如果你使用的是最新版本的Office(包括但不限于Office 2007、Office 2010)则不需要安装此格式包。

好了,下面我就介绍一下PHPWord,大家可以通过访问项目主页下载并获得关于项目的更多信息。

我在使用过程中主要遇到了中文乱码的问题,结合网上大神们的指导,通过下面的方式解决了这类问题,希望对大家有所帮助。

1、增加东亚字体支持

打开并编辑路径/Writer/Word2007/Base.php文件内容,大概在第349行(行数随着版本可能会有变化)大概函数_writeTextStyle内添加:

[php]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. $objWriter->writeAttribute('w:eastAsia'$font)  


比如我的修改片段基本是下面这样:

[php]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. // Font  
  2. if($font != 'Arial') {  
  3.     $objWriter->startElement('w:rFonts');  
  4.         $objWriter->writeAttribute('w:eastAsia'$font); // 添加这行  
  5.         $objWriter->writeAttribute('w:ascii'$font);  
  6.         $objWriter->writeAttribute('w:hAnsi'$font);  
  7.         $objWriter->writeAttribute('w:cs'$font);  
  8.     $objWriter->endElement();  
  9. }  


2. 解决中文乱码问题

编辑PHPWord/Template.php,找到代码$replace = utf8_encode($replace);,删除或者注释掉这行代码,添加$replace = iconv( 'gbk','utf-8', $replace);,比如代码改为如下:

[php]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. /** 
  2.  * Set a Template value 
  3.  *  
  4.  * @param mixed $search 
  5.  * @param mixed $replace 
  6.  */  
  7. public function setValue($search$replace) {  
  8.     if(substr($search, 0, 2) !== '${' && substr($search, -1) !== '}') {  
  9.         $search = '${'.$search.'}';  
  10.     }  
  11.    
  12.     if(!is_array($replace)) {  
  13.         //$replace = utf8_encode($replace);  
  14.         $replace =iconv('gbk''utf-8'$replace); // 注释掉上面行后添加这行  
  15.     }  
  16.    
  17.     $this->_documentXML = str_replace($search$replace$this->_documentXML);  
  18. }  


调用方式如下:

[php]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. $document->setValue('Template', iconv('utf-8''GB2312//IGNORE''中文'));  


上面的代码主要解决模板的问题,下面同样的道理,解决Section添加文本的问题,找到代码$givenText = utf8_encode($text);,删除或者注释掉这行代码,添加$givenText = iconv('gbk', 'utf-8', $text);,比如代码如下:

[php]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. /** 
  2.  * Add a Text Element 
  3.  *  
  4.  * @param string $text 
  5.  * @param mixed $styleFont 
  6.  * @param mixed $styleParagraph 
  7.  * @return PHPWord_Section_Text 
  8.  */  
  9. public function addText($text$styleFont = null, $styleParagraph = null) {  
  10.     //$givenText = utf8_encode($text);  
  11.     $givenText = iconv('gbk''utf-8'$text); // 注释掉上面行后添加这行  
  12.     $text = new PHPWord_Section_Text($givenText$styleFont$styleParagraph);  
  13.     $this->_elementCollection[] = $text;  
  14.     return $text;  
  15. }  


调用方式和上面的模板调用大同小异,这边就不列举了。

折腾了这么多,突然发现网上还有另外一个版本的PhpWord,项目类名大小写上略有不同,隶属于PHPOffice/PHPWordGitHub项目地址文档)。这个版本的PHPWord内容更加丰富,支持的功能也比较多(包括行间距,缩进和首行缩进等),最后我也采取的这个版本的PHPWord,值得注意的是这两个版本的PHPWord在API接口上基本一致,可以通用。但是有些API,在PHPOffice/PHPWord里是不推荐的,比如createSection需要改成addSection,另外应用这个版本的PHPWord不需要像上面那样做任何中文支持的修改,比较省事。

这两个PHPWord项目的官方都提供了较详细的使用例子和文档,这里就不介绍了。最后提示的是:在模板模式下loadTemplate,只能使用setValue等模板操作方法,不能再添加段落或者段落修改了。这个略有不便。

参考文档:phpword 部分BUG修改笔记及心得

对于PHPOffice/PHPWord我提供一个简单的例子供参考(当然官方例子更多):

[php]  view plain  copy
 print ? 在CODE上查看代码片 派生到我的代码片
  1. require_once 'PhpOffice/PhpWord/PhpWord.php'// 包含头文件  
  2. use PhpOffice\PhpWord\Autoloader;  
  3. use PhpOffice\PhpWord\Settings;  
  4. use PhpOffice\PhpWord\IOFactory;  
  5.    
  6. require_once __DIR__ . '/PhpOffice/PhpWord/Autoloader.php';  
  7. Autoloader::register();  
  8. Settings::loadConfig();  
  9.    
  10. // Create a new PHPWord Object  
  11. $PHPWord = new \PhpOffice\PhpWord\PhpWord();  
  12. $PHPWordHelpernew \PhpOffice\PhpWord\Shared\Font();  
  13.    
  14. $PHPWord->setDefaultFontName('仿宋'); // 全局字体  
  15. $PHPWord->setDefaultFontSize(16);     // 全局字号为3号  
  16.    
  17. // 设置文档的属性,这些在对文档右击属性可以看到,也可以省去这些步骤  
  18. $properties = $PHPWord->getDocumentProperties();  
  19. $properties->setCreator('张三');   // 创建者  
  20. $properties->setCompany('某公司'); // 公司  
  21. $properties->setTitle('某某文档'); // 标题  
  22. $properties->setDescription('http://wangye.org'); // 描述  
  23. $properties->setLastModifiedBy('李四'); // 最后修改  
  24. $properties->setCreated( time() );      // 创建时间  
  25. $properties->setModified( time() );     // 修改时间  
  26.    
  27. // 添加3号仿宋字体到'FangSong16pt'留着下面使用  
  28. $PHPWord->addFontStyle('FangSong16pt'array('name'=>'仿宋''size'=>16));  
  29.    
  30. // 添加段落样式到'Normal'以备下面使用  
  31. $PHPWord->addParagraphStyle(  
  32.   'Normal',array(  
  33.     'align'=>'both',  
  34.     'spaceBefore' => 0,  
  35.     'spaceAfter' => 0,  
  36.     'spacing'=>$PHPWordHelper->pointSizeToTwips(2.8),  
  37.     'lineHeight' => 1.19,  // 行间距  
  38.     'indentation' => array// 首行缩进  
  39.       'firstLine' => $PHPWordHelper->pointSizeToTwips(32)  
  40.     )  
  41.   )  
  42. );  
  43.    
  44. // Section样式:上3.5厘米、下3.8厘米、左3厘米、右3厘米,页脚3厘米  
  45. // 注意这里厘米(centimeter)要转换为twips单位  
  46. $sectionStyle = array(  
  47.     'orientation' => null,  
  48.     'marginLeft' => $PHPWordHelper->centimeterSizeToTwips(3),  
  49.     'marginRight' => $PHPWordHelper->centimeterSizeToTwips(3),  
  50.     'marginTop' => $PHPWordHelper->centimeterSizeToTwips(3.5),  
  51.     'marginBottom' => $PHPWordHelper->centimeterSizeToTwips(3.8),  
  52.     'pageNumberingStart' => 1, // 页码从1开始  
  53.     'footerHeight' => $PHPWordHelper->centimeterSizeToTwips(3),  
  54. );  
  55.    
  56. $section = $PHPWord->addSection($sectionStyle); // 添加一节  
  57.    
  58. // 下面这句是输入文档内容,注意这里用到了刚才我们添加的  
  59. // 字体样式FangSong16pt和段落样式Normal  
  60. $section->addText('文档内容''FangSong16pt''Normal');  
  61. $section->addTextBreak(1); // 新起一个空白段落  
  62.    
  63. $objWriter = IOFactory::createWriter($PHPWord'Word2007');  
  64. $objWriter->save('/path/to/file'); // 保存到/path/to/file路径下  

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值