ThinkPHP5结合PhpSpreadsheet实现批量数据导出
在Web项目开发中，将数据库中的数据批量导出为Excel文件是极为常见的业务需求。相较于已经停止维护的PHPExcel，PhpSpreadsheet成为了PHP生态中处理Excel文件的现代标准库。本文将详细讲解如何在ThinkPHP5框架中集成PhpSpreadsheet，并实现高效的批量数据导出功能。在实际开发中，前端通常通过一个 <button> 标签或相关交互组件来触发导出请求，进而访问后端的导出接口地址（例如：https://www.ipipp.com/api/export）来完成下载。
一、安装PhpSpreadsheet
ThinkPHP5支持通过Composer管理依赖，因此安装PhpSpreadsheet非常简便。在项目根目录下打开命令行，执行以下命令：
composer require phpoffice/phpspreadsheet
安装完成后，Composer会自动处理依赖关系，并将库文件加载到项目的vendor目录中。由于PhpSpreadsheet遵循PSR-4命名空间规范，它可以与ThinkPHP5的自动加载机制完美兼容。
二、引入命名空间
在控制器中使用PhpSpreadsheet之前，需要引入相关的核心类。常用的类包括Spreadsheet对象、工作表以及Xlsx写入器：
use PhpOfficePhpSpreadsheetSpreadsheet; use PhpOfficePhpSpreadsheetWriterXlsx;
三、核心导出逻辑实现
批量导出的核心流程主要分为以下几个步骤：
从数据库查询需要导出的数据集
实例化
Spreadsheet对象并获取活动工作表设置表头信息，定义列名称
遍历数据集，逐行填充单元格数据
设置HTTP响应头，强制浏览器以附件形式下载文件
清理内存并终止脚本
下面是一个完整的ThinkPHP5控制器代码示例：
<?php
namespace appindexcontroller;
use thinkController;
use PhpOfficePhpSpreadsheetSpreadsheet;
use PhpOfficePhpSpreadsheetWriterXlsx;
class Export extends Controller
{
public function index()
{
// 1. 获取数据（以用户表为例）
$data = db('user')->select();
// 2. 实例化Spreadsheet对象
$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
// 3. 设置表头
$sheet->setCellValue('A1', 'ID')
->setCellValue('B1', '用户名')
->setCellValue('C1', '邮箱')
->setCellValue('D1', '注册时间');
// 4. 填充数据
$row = 2; // 从第二行开始写入数据
foreach ($data as $item) {
$sheet->setCellValue('A' . $row, $item['id'])
->setCellValue('B' . $row, $item['username'])
->setCellValue('C' . $row, $item['email'])
->setCellValue('D' . $row, $item['create_time']);
$row++;
}
// 5. 清除输出缓冲区，防止出现乱码或文件损坏
if (ob_get_contents()) {
ob_end_clean();
}
// 6. 设置HTTP响应头，触发浏览器下载
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="user_list.xlsx"');
header('Cache-Control: max-age=0');
// 7. 写入Excel文件并输出
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
// 8. 释放内存，防止内存泄漏
$spreadsheet->disconnectWorksheets();
unset($spreadsheet);
// 终止脚本执行
exit;
}
}四、大数据量导出优化
当导出数万甚至数十万条数据时，直接一次性读取并生成Excel极易导致PHP内存溢出（Fatal Error: Allowed memory size exhausted）。针对此类场景，需要进行针对性优化：
1. 数据库查询优化
避免使用select()一次性将所有数据加载到内存。ThinkPHP5支持分块查询，可以分批从数据库获取数据，降低内存峰值占用：
$row = 2;
db('user')->chunk(1000, function($users) use ($sheet, &$row) {
foreach ($users as $item) {
$sheet->setCellValue('A' . $row, $item['id'])
->setCellValue('B' . $row, $item['username'])
->setCellValue('C' . $row, $item['email'])
->setCellValue('D' . $row, $item['create_time']);
$row++;
}
});2. 使用单元格缓存机制
PhpSpreadsheet允许将单元格数据缓存到磁盘、Memcached或Redis中，而非全部驻留在内存中。可以在实例化前配置缓存设置，将数据写入临时文件：
use PhpOfficePhpSpreadsheetSettings;
// 设置使用临时文件缓存单元格数据
$cacheDir = __DIR__ . '/tmp/';
if (!is_dir($cacheDir)) {
mkdir($cacheDir);
}
Settings::setCache(new PhpOfficePhpSpreadsheetCacheFilesystem($cacheDir));3. 及时释放变量
在数据填充的循环中，对不再使用的变量及时执行unset()，并在导出完成后主动断开工作表连接，释放内存空间。
五、表格样式设置
实际业务中，导出的Excel往往需要具备一定的排版美感，如表头加粗、居中对齐等。PhpSpreadsheet提供了丰富的样式设置API：
use PhpOfficePhpSpreadsheetStyleAlignment;
use PhpOfficePhpSpreadsheetStyleFill;
// 获取表头单元格范围
$headerRange = 'A1:D1';
// 设置表头字体加粗
$sheet->getStyle($headerRange)->getFont()->setBold(true);
// 设置表头文字居中对齐
$sheet->getStyle($headerRange)->getAlignment()->setHorizontal(Alignment::HORIZONTAL_CENTER);
// 设置表头背景色
$sheet->getStyle($headerRange)->getFill()->setFillType(Fill::FILL_SOLID)->getStartColor()->setRGB('EEEEEE');六、总结
通过ThinkPHP5与PhpSpreadsheet的结合，可以轻松构建出强大且灵活的数据导出功能。在处理少量数据时，基础的查询与写入逻辑足以胜任；而在面对海量数据导出时，合理利用分块查询与缓存机制则是保障系统稳定运行的关键。掌握这些实践方案，能够帮助开发者在项目中高效、优雅地完成Excel数据导出需求。