phpspreadsheet是当前最稳定的php excel操作库,支持.xlsx格式、单元格样式、多工作表、公式计算等完整功能;需通过composer安装phpoffice/phpspreadsheet,实例化spreadsheet后写入数据并设置响应头输出,注意列宽自适应须在数据写入后调用。

用PHP框架导出Excel文件时,直接拼接原始XML或CSV容易出错、不兼容样式和公式,必须借助成熟库完成结构化生成。PhpSpreadsheet是当前最稳定的PHP Excel操作库,支持.xlsx格式、单元格样式、多工作表、公式计算等完整功能。
安装PhpSpreadsheet依赖
在Laravel、ThinkPHP或原生PHP项目中,统一使用Composer安装:
执行命令:composer require phpoffice/phpspreadsheet
安装完成后,vendor/autoload.php会被自动加载,无需手动require —— 【若手动引入autoload.php失败,导出将报Class not found错误】。
基础导出:单工作表纯数据写入
方法一:面向对象方式(推荐)
① 实例化Spreadsheet对象:$spreadsheet = new \PhpOffice\PhpSpreadsheet\Spreadsheet();
② 获取默认工作表:$sheet = $spreadsheet->getActiveSheet();
③ 逐行写入数据:$sheet->setCellValue('A1', '姓名')->setCellValue('B1', '年龄')->setCellValue('C1', '城市');
这一步不能跳过设置列头,否则Excel打开后会显示空白列,且后续filter、排序功能失效。
④ 填充数据行(示例3条):
$sheet->fromArray([['张三', 28, '杭州'], ['李四', 32, '深圳'], ['王五', 25, '北京']], NULL, 'A2');
⑤ 设置HTTP响应头并输出:
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="user_export.xlsx"');
$writer = new \PhpOffice\PhpSpreadsheet\Writer\Xlsx($spreadsheet);
$writer->save('php://output');
带样式的导出:标题加粗+列宽自适应
方法二:链式调用设置格式
在写入标题后立即设置样式:
$sheet->getStyle('A1:C1')->getFont()->setBold(true);
冻结首行以便滚动查看:
$sheet->freezePane('A2');
自动调整列宽(仅对已写入内容生效):
$sheet->getColumnDimension('A')->setAutoSize(true);
$sheet->getColumnDimension('B')->setAutoSize(true);
$sheet->getColumnDimension('C')->setAutoSize(true);
注意:setAutoSize(true)必须在数据写入后调用,否则列宽为0——【提前调用会导致Excel打开时报错“无法读取内容”】。
多工作表导出:按分类拆分数据
方法一:创建新工作表并切换上下文
第一步:保留默认表用于“用户总表”,写入汇总数据;
第二步:新建工作表:$detailSheet = $spreadsheet->createSheet();
第三步:重命名该表:$detailSheet->setTitle('2024订单明细');
第四步:向新表写入数据:$detailSheet->fromArray($orderData, NULL, 'A1');
第五步:激活第一个工作表为默认打开页:$spreadsheet->setActiveSheetIndex(0);
这一步决定用户双击Excel文件时最先看到哪张表,不设会默认停留在最后创建的表上。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











