PHPExcel:用于Excel等文档生成的PHP开源类库

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中一些常用的代码段:

  1 <?php  
  2 // 导入PHPExcel类库  
  3 require_once("Classes/PHPExcel.php");  
  4   
  5 // 通常PHPExcel对象有两种实例化的方式  
  6 // 1. 通过new关键字创建空白文档  
  7 $phpexcel = new PHPExcel();  
  8   
  9 // 2. 通过读取已有的模板创建  
 10 $phpexcel = PHPExcel_IOFactory::createReader("Excel5")->load("template.xls");  
 11   
 12 /**  
 13  * 实例化之后的PHPExcel对象类似于一个暂存于内存中文档文件,  
 14  * 可以对它进行操作以达到修改文档数据的目的 
 15  */  
 16 // 设置文档属性  
 17 $phpexcel->getProperties()->setCreator("Liu Jian") // 文档作者  
 18                           ->setLastModifiedBy("Liu Jian") // 最后一次修改者  
 19                           ->setTitle("Office 2003 XLS Test Document") // 标题  
 20                           ->setSubject("Office 2003 XLS Test Document") // 主题  
 21                           ->setDescription("Test document for Office 2003 XLS, generated using PHPExcel.") // 备注  
 22                           ->setKeywords("office 2003 openxml php") // 关键字  
 23                           ->setCategory("Test result file"); // 类别  
 24                             
 25 // 默认状态下,新创建的空白文档(通过new)只有一个工作表(sheet),且它的编号(index)为0  
 26 // 可以通过如下的方式添加新的工作表  
 27 $phpexcel->createSheet(1);  
 28   
 29 // 获取已有编号的工作表  
 30 $sheet = $phpexcel->getSheet(1);  
 31   
 32 // 设置当前激活的工作表编号  
 33 $phpexcel->setActiveSheetIndex(1);  
 34   
 35 // 获取当前激活的工作表  
 36 $sheet = $phpexcel->getActiveSheet();  
 37   
 38 // 得到工作表之后就可以操作它的单元格以修改数据了  
 39 // 修改工作表的名称  
 40 $sheet->setTitle("Test");  
 41   
 42 // 设置单元格A5的值  
 43 $sheet->setCellValue("A5", date('Y-m-d h:i:s'));  
 44   
 45 // 设置第3行第5列(E3)的值  
 46 $sheet->setCellValueByColumnAndRow(4, 3, date('Y-m-d h:i:s'));  
 47   
 48 // 获取单元格A5的值  
 49 $sheet->getCell("A5")->getValue();  
 50   
 51 // 合并单元格  
 52 $sheet->mergeCells("C3:G6");  
 53   
 54 // 拆分合并的单元格  
 55 $sheet->unmergeCells("C3:G6");  
 56   
 57 // 设置第3行的属性  
 58 $sheet->getRowDimension(3)->setRowHeight(100) // 行高  
 59                           ->setVisible(true) // 是否可见,默认为true   
 60                           ->setRowIndex(6) // 变更行号为6  
 61                           ->setOutlineLevel(5); // 优先级别,默认为0,参数必须是0到7  
 62   
 63 // 设置第F列的属性  
 64 // getColumnDimension("F")可以用getColumnDimensionByColumn(5)代替  
 65 $sheet->getColumnDimension("F")->setWidth(200) // 列宽  
 66                                ->setColumnIndex("I") // 变更列号为I  
 67                                ->setVisible(false) // 是否可见  
 68                                ->setAutoSize(true); // 自动适应列宽  
 69               
 70 // 在第3行前面插入1行,该行将变成新的第3行,其它的依次下移1行  
 71 $sheet->insertNewRowBefore(3, 1);  
 72   
 73 // 在第C行前面插入1列,该列将变成新的第C列,其它的依次右移1列  
 74 $sheet->insertNewColumnBefore("C", 1); // 方法一  
 75 $sheet->insertNewColumnBeforeByIndex(2, 1); // 方法二,第C列又是第2列  
 76   
 77 // 获取单元格D3的样式对象  
 78 $style = $sheet->getStyle("D3"); // 等价于getStyleByColumnAndRow(3, 3)  
 79   
 80 // 设置该单元格的字体属性  
 81 $style->getFont()->setBold(true) // 是否粗体  
 82                  ->setSize(16) // 字号  
 83                  ->setName("Gungsuh") // 字体名,只适用于外文字体  
 84                  ->setItalic(true) // 是否斜体  
 85                  ->setStrikethrough(true) // 是否有删除线  
 86                  ->setUnderline(PHPExcel_Style_Font::UNDERLINE_DOUBLEACCOUNTING) // 下划线类型  
 87                  ->getColor()->setARGB(PHPExcel_Style_Color::COLOR_BLUE); // 字体颜色  
 88                    
 89 // 设置该单元格的背景填充属性  
 90 $style->getFill()->setFillType(PHPExcel_Style_Fill::FILL_SOLID) // 填充模式  
 91                  ->getStartColor()->setARGB(PHPExcel_Style_Color::COLOR_YELLOW); // 背景颜色  
 92   
 93 // 设置该单元格中数字的格式  
 94 $style->getNumberFormat()->setFormatCode("0.00");  
 95   
 96 // 设置该单元格中文本对齐方式  
 97 $style->getAlignment()->setHorizontal(PHPExcel_Style_Alignment::HORIZONTAL_CENTER) // 水平方向  
 98                       ->setVertical(PHPExcel_Style_Alignment::VERTICAL_CENTER); // 垂直方向  
 99   
100 $sheet->setCellValue("D3", "12.3456");  
101   
102 // 在本地保存文档  
103 PHPExcel_IOFactory::createWriter($phpexcel, 'Excel5')->save("output.xls");  
104   
105 // 输出文档到页面  
106 header('Content-Type: application/vnd.ms-excel');  
107 header('Content-Disposition: attachment;filename="test.xls"');  
108 header('Cache-Control: max-age=0');  
109 PHPExcel_IOFactory::createWriter($phpexcel, 'Excel5')->save('php://output');  
110 ?>  

需要注意的是:

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://blog.csdn.net/sadfishsc/article/details/7543291