phpexcel是一个十分强大的文档生成php开源类库,它不仅支持生成excel(.xls)、excel2007(.xlsx)文档,同时也支持pdf、html、csv文档的生成。此外,phpexcel还支持以现有的excel文档为模板填充数据生成新的以上文档。并且,其本身的api文档和示例demo相当
phpexcel是一个十分强大的文档生成php开源类库,它不仅支持生成excel(.xls)、excel2007(.xlsx)文档,同时也支持pdf、html、csv文档的生成。此外,phpexcel还支持以现有的excel文档为模板填充数据生成新的以上文档。并且,其本身的api文档和示例demo相当完整,非常有助于开发人员使用。
phpexcel的官方网站如下:
http://phpexcel.codeplex.com/
当前的版本是1.7.6,下载解压后的phpexcel的目录结构如下所示:
其中:
classes目录下是phpexcel的源代码文件:phpexcel.php文件是类库的接口,外部的php代码通过它来实现对phpexcel的调用;phpexcel目录下是各种不同文档(如excel、excel2007、pdf等)的读取和生成的具体操作代码,它们由classes目录下的phpexcel.php文件通过工厂模式统一进行调用。
documentation目录下是phpexcel的官方帮助文档,尤其是api目录下网页文件全部是phpexcel的api帮助文档,而其它的则是对这个开源项目的介绍。
tests目录下是phpexcel的将近40个示例小程序,可以与classes目录一同放到apache+php环境下进行测试与学习。
下面是phpexcel中一些常用的代码段:
load(template.xls);/** * 实例化之后的phpexcel对象类似于一个暂存于内存中文档文件, * 可以对它进行操作以达到修改文档数据的目的 */// 设置文档属性$phpexcel->getproperties()->setcreator(liu jian) // 文档作者 ->setlastmodifiedby(liu jian) // 最后一次修改者 ->settitle(office 2003 xls test document) // 标题 ->setsubject(office 2003 xls test document) // 主题 ->setdescription(test document for office 2003 xls, generated using phpexcel.) // 备注 ->setkeywords(office 2003 openxml php) // 关键字 ->setcategory(test result file); // 类别 // 默认状态下,新创建的空白文档(通过new)只有一个工作表(sheet),且它的编号(index)为0// 可以通过如下的方式添加新的工作表$phpexcel->createsheet(1);// 获取已有编号的工作表$sheet = $phpexcel->getsheet(1);// 设置当前激活的工作表编号$phpexcel->setactivesheetindex(1);// 获取当前激活的工作表$sheet = $phpexcel->getactivesheet();// 得到工作表之后就可以操作它的单元格以修改数据了// 修改工作表的名称$sheet->settitle(test);// 设置单元格a5的值$sheet->setcellvalue(a5, date('y-m-d h:i:s'));// 设置第3行第5列(e3)的值$sheet->setcellvaluebycolumnandrow(4, 3, date('y-m-d h:i:s'));// 获取单元格a5的值$sheet->getcell(a5)->getvalue();// 合并单元格$sheet->mergecells(c3:g6);// 拆分合并的单元格$sheet->unmergecells(c3:g6);// 设置第3行的属性$sheet->getrowdimension(3)->setrowheight(100) // 行高 ->setvisible(true) // 是否可见,默认为true ->setrowindex(6) // 变更行号为6 ->setoutlinelevel(5); // 优先级别,默认为0,参数必须是0到7// 设置第f列的属性// getcolumndimension(f)可以用getcolumndimensionbycolumn(5)代替$sheet->getcolumndimension(f)->setwidth(200) // 列宽 ->setcolumnindex(i) // 变更列号为i ->setvisible(false) // 是否可见 ->setautosize(true); // 自动适应列宽 // 在第3行前面插入1行,该行将变成新的第3行,其它的依次下移1行$sheet->insertnewrowbefore(3, 1);// 在第c行前面插入1列,该列将变成新的第c列,其它的依次右移1列$sheet->insertnewcolumnbefore(c, 1); // 方法一$sheet->insertnewcolumnbeforebyindex(2, 1); // 方法二,第c列又是第2列// 获取单元格d3的样式对象$style = $sheet->getstyle(d3); // 等价于getstylebycolumnandrow(3, 3)// 设置该单元格的字体属性$style->getfont()->setbold(true) // 是否粗体 ->setsize(16) // 字号 ->setname(gungsuh) // 字体名,只适用于外文字体 ->setitalic(true) // 是否斜体 ->setstrikethrough(true) // 是否有删除线 ->setunderline(phpexcel_style_font::underline_doubleaccounting) // 下划线类型 ->getcolor()->setargb(phpexcel_style_color::color_blue); // 字体颜色 // 设置该单元格的背景填充属性$style->getfill()->setfilltype(phpexcel_style_fill::fill_solid) // 填充模式 ->getstartcolor()->setargb(phpexcel_style_color::color_yellow); // 背景颜色// 设置该单元格中数字的格式$style->getnumberformat()->setformatcode(0.00);// 设置该单元格中文本对齐方式$style->getalignment()->sethorizontal(phpexcel_style_alignment::horizontal_center) // 水平方向 ->setvertical(phpexcel_style_alignment::vertical_center); // 垂直方向$sheet->setcellvalue(d3, 12.3456);// 在本地保存文档phpexcel_iofactory::createwriter($phpexcel, 'excel5')->save(output.xls);// 输出文档到页面header('content-type: application/vnd.ms-excel');header('content-disposition: attachment;filename=test.xls');header('cache-control: max-age=0');phpexcel_iofactory::createwriter($phpexcel, 'excel5')->save('php://output');?>
需要注意的是:
1. phpexcel本身具有在单元格中插入图片以及设置单元格边框的相关函数,但是个人感觉动态添加图片、设置边框远没有使用静态的excel模版来生成文档更好用。实在需要的情况下可以参见最后的参考资料。
2. 添加新的行或列时,新的行或列的样式(style)会自动与新行/列的前一行/列保持一致。
3. 设置单元格填充颜色时,必须先设定填充模式,否则会失效。
4. 通过phpexcel_iofactory的静态方法createreader或createwriter,必须传入文档格式所对应的参数字符串,其中:
excel5对应excel 2003(.xls)excel2007对应excel 2007(.xlsx)pdf对应pdf(.pdf)csv对应csv(.csv)输出文档时,文件的扩展名必须与该参数字符串相契合。
参考资料:http://apps.hi.baidu.com/share/detail/35261920