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

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

[php] view plaincopy

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. ?>  

[php] view plain copy

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://apps.hi.baidu.com/share/detail/35261920