前言

数据导出到excel是日常开发最常见的功能了，如果每一个数据导出都要写一堆难看的代码，那未免太耗时耗力。这里本人封装了一个导出数据到excel的类库，支持大数据导出、多种样式简单实用，写法简单，类库在composer中，这里主要进行使用及文档讲解。

本人导出excel功能是基于PHPSpreadSheet，这里给大家提供下文档地址，中文翻译的不咋地，不过还能勉强看看。官方英文文档就别为难我了。

中文文档（非官方）

英文文档（官方）

为什么要给你们看文档？因为本类库是基于PHPSpreadSheet，那么无疑能够使用PHPSpreadSheet原本的方法来进行你的自定义操作。具体如何自己操作，看下面讲解。

为方便个人使用，自封装类库概览功能如下：

1. 导出方法的实现
2. 设置表头，并定义文字、颜色、行高等多种样式
3. 简单使用缓存，减少内存消耗
4. 第一行写合并的标题行
5. 可以自定义添加要的格式或者处理（使用对象，随时可以再进行二次处理使用 & ）
6. 导出文件的方式：a. 直接传递给浏览器下载；b. 生成自定义名称文件在服务器中

使用示例

这里先给大家展示一下最常见的几种写法

当然，在这之前，需要先composer下本类库：

composer require millionmile/php-spreadsheet

写法一

这是一种最简易方式的写法了。

$header = ['ID','姓名','电话'];
$data=[
    [1,'A','111'],
    [2,'B','222'],
];
$exportObj = new \MillionMile\PHPSpreadsheet\ExportService($header);
$exportObj->appendData($data);
$exportObj->generateFile(__DIR__, 'YourExcelName');

导出excel效果如下：

写法二

最常用的写法当属它无疑。

$header = [
    'ID'=>'id',
    '姓名'=>'name',
    '电话'=>'phone'
];
$exportObj = new \MillionMile\PHPSpreadsheet\ExportService($header);

for($i=1;$i<10;$i++){
    
    
    $data = [
        ['id'=>1,'name'=>'A','phone'=>'111','trash'=>'no export'],
        ['id'=>2,'name'=>'B','phone'=>'222','trash'=>'no export'],
     ];
    $exportObj->appendData($data);
}


$exportObj->generateFile('YourFilePath', 'YourExcelName');

导出excel效果如下：

把上面的for改为数据库的分页获取数据，那么用起来就相当顺滑了

从数据库中获取数据，假设有这样一张表（user）：

代码如下：

$servername = "YourServerName";
$username = "YourUserName";
$password = "Yourpassword";
$dbname = "YourDbName";

// 创建连接。原生写法，相信实际使用你不是这样的，这里参考就行
$conn = new mysqli($servername, $username, $password, $dbname);
// Check connection
if ($conn->connect_error) {
    
    
    die("连接失败: " . $conn->connect_error);
}


$header = [
    'ID'=>'id',
    '姓名'=>'name',
    '电话'=>'phone'
];
$exportObj = new \MillionMile\PHPSpreadsheet\ExportService($header);

$page = 0;
$pageSize = 100;

$sql = "SELECT COUNT(*) FROM user";
$result = $conn->query($sql);
$a = $result->fetch_assoc();
$total = current($a);
$lastId = 0;
while (true) {
    
    
    echo $page . '/' . $totalPage . PHP_EOL;	//看看当前跑到第几页
    $offect = $page * $pageSize;
    
    //获取数据库数据。原生写法，相信实际使用你不是这样的，这里参考就行
    $sql = "SELECT * FROM user where id > {
      
      $lastId} limit {
      
      $pageSize}";
    $result = $conn->query($sql);
    $data = mysqli_fetch_all($result, MYSQLI_ASSOC);
    
    if (empty($arr)) {
    
    
        //如果没有数据，那么结束数据的读取
        break;
     }
    $exportObj->appendData($data);	//将数据库的数据加入到excel中
    $lastId = end($arr)['id'];	   //更新最后读取到的表id
    $page++;
}

$exportObj->generateFile('YourFilePath', 'YourExcelName');

写法三

为了让自己的excel不那么难看，又不想写一堆样式代码怎么办？用它，简简单单样式好看起来

$header = [
    'ID'=>[
       'field'=>'id',
       'style'=>[
           'font_bold'=>true
       ]
     ],
    '姓名'=>[
		'field'=>'name',
       'style'=>[
           'font_color:2'=>'FF0000',
           'horizontal'=>'center'
       ]
     ],
    '电话'=>'phone'
];
$exportObj = new \MillionMile\PHPSpreadsheet\ExportService($header);

for($i=1;$i<10;$i++){
    
    
    $data = [
        ['id'=>1,'name'=>'A','phone'=>'111','trash'=>'no export'],
        ['id'=>2,'name'=>'B','phone'=>'222','trash'=>'no export'],
     ];
    $exportObj->appendData($data);
}


$exportObj->generateFile('YourFilePath', 'YourExcelName');

导出excel效果如下：

相信有一定编程经验的同学已经能够看出个所以然来，接下来我们来具体讲解一下，上述例子中参数的具体可填内容。

ExportService类库方法

ExportService是唯一对外操作类。可用方法如下：

1. 实例化

ExportService类构造函数有两个参数，其中$header必填，$cache选填。

代码示例：

$header = [
    'ID'=>'id',
    '姓名'=>'name',
    '电话'=>'phone'
];
$exportObj = new \MillionMile\PHPSpreadsheet\ExportService($header,'redis');

2. 填充数据

appendData方法是追加数据到excel表格的常用方法，该方法在实例化ExportService对象可使用，必须在导出excel方法前使用（导出了还能追加啥子数据）。它的参数只有一个，就是下文"参数相关文档"中的$data参数，具体写法参照下面即可。

代码示例：

$data = [
        ['id'=>1,'name'=>'A','phone'=>'111','trash'=>'no export'],
        ['id'=>2,'name'=>'B','phone'=>'222','trash'=>'no export'],
     ];
$exportObj->appendData($data);

3. 设置大标题行

setBigTitle方法用于在首行设置合并标题行所占列的单元格，并填写进相关文本。

代码示例：

$exportObj->setBigTitle('我是长标题');

4. 自定义操作PHPSpreadsheet

不得不说，PHPSpreadsheet有大量的操作，本类库仅对其常用的几种操作进行封装，肯定会存在你想要的某种特殊操作，本类库给不了你。这时候，你可以选择使用PHPSpreadsheet自己的操作去完成你的需要。这里提供一个让你能够使用PHPSpreadsheet当前活动sheet对象的途径——getActiveSheet()方法。

代码示例：

//获取文件操作变量，可自由使用PHPSpreadsheet原生操作
$sheet = &$exportObj->getActiveSheet(); //不加引用也可

$sheet->setCellValue('D4', 'yes');	//设置D4列的文本内容为'yes'

5. 导出excel方法

本类库中，目前导出excel的方法有两种：生成文件到服务器某位置中、直接返回给浏览器进行下载。

1) 生成文件到服务器某位置中

上文示例中也存在，生成文件到服务器某位置中方法即是generateFile方法。

public function generateFile( string $fileDir, string $fileName): string

generateFile()方法有两个参数，一个是文件生成路径$fileDir，用于设置生成的excel文件所在的路径。另一个是文件名称$fileName，设置生成的excel文件的文件名（注意：不可加文件后缀名。默认生成文件为xlsx）。

该函数返回的结果是生成的excel文件所在路径（字符串类型）。

代码示例：

$exportObj->generateFile(__DIR__, 'YourExcelName');		//生成excel文件到执行文件的同一级目录中

2) 直接返回给浏览器进行下载

download()方法是将生成的excel文件保存在output流中，直接传递给浏览器进行下载。其参数只有一个$fileName文件名称：设置生成的excel文件的文件名（注意：不可加文件后缀名。默认生成文件为xlsx）。

public function download(string $fileName): void

注意：

1. 运行download方法后，程序变将终止运行，后续操作不再执行。
2. 若文件较大，传输时间过长，浏览器终止访问，其处理方式本类库不提供，请自行参照其他方法进行处理。

代码示例：

$exportObj->download('YourFileName');		//生成自定义文件名给浏览器进行下载

6. 设置当前工作表标题

setSheetName()方法是设置当前活动工作表的简单方法，其参数只有一个$sheetName。

代码示例：

$exportObj->setSheetName('YourSheetName');	//设置自定义的sheet名称

参数相关文档

1. $header参数

$header参数为二维数组时，可与一维数组自定键名方式混合使用，当不支持与一维数组自然键名方式混合使用。

下面具体讲解下$header二维数组方式下的style参数

1) style参数

为方便针对各列甚至各单元格设置统一的样式，在$header二维数组方式中使用style参数来进行统一方便的样式设置。具体可设置的常用样式如下：

2) style参数键名

style参数的键名，原本是写入指定的样式用。这里为方便使用，对其进行扩展，可设置样式作用的范围（键名后面:的即为范围）。用法见下表：

2. $cache参数

为什么要使用缓存？PHPSpreadsheet类库无疑很方便操作，但是其消耗的内存不是一般的小，

官方说明： `PhpSpreadsheet在工作表中平均每个单元格使用约1k，因此大型工作簿可以迅速用尽可用内存。

注意：若要使用APCu缓存、Redis缓存、Memcache缓存等缓存方式，请自行配置调通后，才能正常进行使用。

特别注意：使用cache无疑可以减少大量的内存消耗，但如果要导出的数据过多，还是会存在爆内存的情况。设置合理的可用内存跟数据大小有关。在程序中，修改可用内存可参照下面代码：

ini_set('memory_limit','500M'); //设置可用内存为500M
ini_set('memory_limit','-1');   //-1代表不进行内存限制，谨慎操作

3. $data参数

$data支持的参数形式都是二维数组。其中一维数组内元素属于自然键名（不是也没关系）按先后顺序填入。二维数组内元素可选择自定键名或自然键名，具体说明见下表。

总结

本类库并不是特别完善，还有些值得再去优化和补充。本人已有计划追加功能：

• 大数据采用csv封装导出

• 设置默认单元格、行、列样式

• 使用excel导入数据到数据库中

• 支持多sheet操作

如果你有什么好想法，也欢迎在评论区留言，让这个小家伙变得强壮起来吧