ThinkPHP用PHPExcle导出Excel文件

本篇博客主要讲述,如何在thinkPHP中使用PHPExcel中导出Excel文件,是博主在实践了好多篇别人的帖子之后,总结归纳出来的文章,亲测可用。

准备工作

下载、配置PHPExcel扩展插件

  1. PHPExcel的官网或者github去下载最新PHPExcel放到ThinkPHP/Library/Vendor目录下,Vendor目录是放置PHP扩展包的默认文件夹,在Vendor目录下建立PHPExcel文件夹,将下载的文件,解压到此处。

  2. PHPExcel.php文件,重命名成PHPExcel.class.php

    至此,插件安装已经做好,目录结构如下图,接下来做功能部分。

    Markdown

创建Excel方法

生成Excel文件方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
/**
* 数据导出为.xls格式
* @param string $fileName 导出的文件名
* @param $expCellName array -> 数据库字段以及字段的注释
* @param $expTableData Model -> 连接的数据库
*/
public function exportExcel($fileName='table',$expCellName,$expTableData){
$xlsTitle = iconv('utf-8', 'gb2312', $fileName);//文件名称
$xlsName = $fileName.date("_Y.m.d_H.i.s"); //or $xlsTitle 文件名称可根据自己情况设定
$cellNum = count($expCellName);
$dataNum = count($expTableData);

import("Vendor.PHPExcel.PHPExcel");
import("Vendor.PHPExcel.Writer.Excel5");
import("Vendor.PHPExcel.IOFactory.php");

$objPHPExcel = new \PHPExcel();
$cellName = array('A','B','C','D','E','F','G','H','I','J','K','L','M','N','O','P','Q','R','S','T','U','V','W','X','Y','Z','AA','AB','AC','AD','AE','AF','AG','AH','AI','AJ','AK','AL','AM','AN','AO','AP','AQ','AR','AS','AT','AU','AV','AW','AX','AY','AZ');

$objPHPExcel->getActiveSheet(0)->mergeCells('A1:'.$cellName[$cellNum-1].'1');//合并单元格
$objPHPExcel->setActiveSheetIndex(0)->setCellValue('A1', $fileName.' Export time:'.date('Y-m-d H:i:s'));
for($i=0;$i<$cellNum;$i++){
$objPHPExcel->setActiveSheetIndex(0)->setCellValue($cellName[$i].'2', $expCellName[$i][1]);
}
// Miscellaneous glyphs, UTF-8
for($i=0;$i<$dataNum;$i++){
for($j=0;$j<$cellNum;$j++){
$objPHPExcel->getActiveSheet(0)->setCellValue($cellName[$j].($i+3), $expTableData[$i][$expCellName[$j][0]]);
}
}

header('pragma:public');
header('Content-type:application/vnd.ms-excel;charset=utf-8;name="'.$xlsTitle.'.xls"');
header("Content-Disposition:attachment;filename=$xlsName.xls");//attachment新窗口打印inline本窗口打印
$objWriter = \PHPExcel_IOFactory::createWriter($objPHPExcel, 'Excel5');
$objWriter->save('php://output');
exit;
}

方法生成说明

  1. 第9行的

    $xlsName = $fileName.date("_Y.m.d_H.i.s"); //or $xlsTitle 文件名称可根据自己情况设定

    是设置文件名,上面所写是文件名_Y.m.d_H.i.s_Y.m.d_H.i.s即是导出的时间,因为windows下,文件名中不能含有:,所以即便写成_Y.m.d_H:i:s,导出的文件也是_Y.m.d_H.i.s这种样式。

  2. 第13行~15行的

    1
    2
    3
    import("Vendor.PHPExcel.PHPExcel");
    import("Vendor.PHPExcel.Writer.Excel5");
    import("Vendor.PHPExcel.IOFactory.php");

    这三行即是引入PHPExcel,因为当时的文件目录结构是ThinkPHP/Library/Vendor/PHPExcel,所以import("Vendor.PHPExcel.PHPExcel");,注意目录结构,只要引入的位置和放置PHPExcel的目录相同即可;

  3. 第20、21行的

    1
    2
    $objPHPExcel->getActiveSheet(0)->mergeCells('A1:'.$cellName[$cellNum-1].'1');//合并单元格
    $objPHPExcel->setActiveSheetIndex(0)->setCellValue('A1', $fileName.' Export time:'.date('Y-m-d H:i:s'));

    此作用是,在Excel文件的第一行合并一行单元格,用作表格的标题或简介。如下图所示:

    Markdown

    setCellValue('A1', $fileName.' Export time:'.date('Y-m-d H:i:s'));值可以根据自己需求修改;

  4. 第34行的
    header("Content-Disposition:attachment;filename=$xlsName.xls");//attachment新窗口打印inline本窗口打印

    可以设置输出的文件格式,此处写的是.xls,可修改成.xlsx

  5. 此方法调用时需要传入三个参数(在方法开头的注释中已经说了),这里再具体说明一下:

    1
    2
    3
    $fileName     导出的文件的文件名
    $expCellName 数据库字段以及字段的注释(数组)
    $expTableData 连接的数据库

方法调用

调用方法

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
/**导出**/
public function msgOut(){
$excel = A('Excel');
$xlsCell = array(
array('id', 'ID'),
array('staff_name', '昵称'),
array('staff_real', '真实姓名'),
array('mobile', '手机号'),
array('card_id', '身份证号'),
array('referee', '推荐人'),
array('game_id', '游戏ID'),
array('money', '余额'),
array('consume_coin', '消费币'),
array('create_time', '注册时间'),
array('status', '状态'),
);
$xlsName = 'Staff表搜索结果导出';
$field = null;
foreach ($xlsCell as $key => $value) {
if($key == 0){
$field = $value[0];
}else{
$field .= "," . $value[0];
}
}
$xlsModel = M('Staff');
if (IS_POST) {
$map = $this -> _queryTime();
$staff_name = I('staff_name');
if($staff_name) {
if (is_numeric($staff_name)) {
$map["id|staff_name"] = array(intval($staff_name), array('like', '%' . $staff_name . '%'), '_multi' => true);
} else {
$map['staff_name'] = array('like', '%' . (string)$staff_name . '%');
}
}
$xlsData = $xlsModel->Field($field)->where($map)->order('id DESC')->select();
}
foreach ($xlsData as $k => $v) {
$xlsData[$k]['create_time'] = $v['create_time'] == null ? '-' : date("Y-m-d H:i",$v['create_time']);
$xlsData[$k]['status'] = $v['status'] == 1 ? '正常' : '禁用';
}
$excel->exportExcel($xlsName,$xlsCell,$xlsData);
}

调用说明

  1. 第3行
    $excel = A('Excel');
    这个方法我写在了Application/Admin/Controller/ExcelController.class.php中,当前用的控制器是MainController.class.php,调用其他控制器中的方法,用TP中自带的A(),所以第51行,用的是$excel->exportExcel($xlsName,$xlsCell,$xlsData);,如果你的exportExcel()方法和当前调用的方法在同一个控制器内,那么第三行可以不写,第51行改成$this->exportExcel($xlsName,$xlsCell,$xlsData);

  2. 第4行
    $xlsCell是导出这张表中所有的字段,以及字段的注释,导出后,不能把字段作为表格的列名,不知道数据库字段是什么意思的用户,看了这张表也不知所以然。

  3. 第17~24行
    是根据$xlsCell数组中,提取出来字段名,作为一个字符串,在查询时使用。当然也可以把这个字段名的字符串手写出来,我这里用的是foreach处理。

  4. 第27~38行
    是查询条件和查询结果,如果没有查询条件,想把整张表导出的话,直接用$xlsData = $xlsModel->Field($field)->order('id DESC')->select();即可。

  5. 第47~50行
    是对$xlsData结果进行处理,我写的两个意思是:
    1、当create_time字段为空的时候,值为 - ,有值的时候,就用date()函数把时间戳处理成日期;
    2、当status字段的值为1的时候,显示为正常,当值为0的时候禁用

有点罗嗦了,见谅。

模板文件

模板文件很简单,就一个提交。

1
2
3
4
5
6
7
8
9
10
<form action="{:U('Main/msgOut')}" method="post" class="form-horizontal">
<div class="search-form fr cf">
<div class="sleft">
<input type="text" class="search-input" onClick="WdatePicker()" name="start_time" style="cursor: pointer;" value="{:I('start_time')}" id="start" placeholder="开始日期" />
<input type="text" class="search-input" onClick="WdatePicker()" name="end_time" style="cursor: pointer;" value="{:I('end_time')}" id="end" placeholder="结束日期" />
<input type="text" name="staff_name" class="search-input" value="{:I('staff_name')}" id="name" placeholder="输入推广专员的昵称或者ID">
<button type="submit" class="btn" id="out">导出</button>
</div>
</div>
</form>

form表单中三个input,是搜索条件,如果没有的话,直接写button即可。

文章结束,欢迎转载。