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

  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
// 导入PHPExcel类库
require_once("Classes/PHPExcel.php");

// 通常PHPExcel对象有两种实例化的方式
// 1. 通过new关键字创建空白文档
$phpexcel = new PHPExcel();

// 2. 通过读取已有的模板创建
$phpexcel = PHPExcel_IOFactory::createReader("Excel5")->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

  • 1
    点赞
  • 0
    收藏
    觉得还不错? 一键收藏
  • 0
    评论
评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

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

抵扣说明:

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

余额充值