ThinkPHP怎么处理Excel导入_ThinkPHP读取表格数据方法【方法】-ThinkPHP-PHP中文网

thinkphp需依赖phpoffice/phpspreadsheet解析excel，因excel是zip+xml/ole二进制格式，fgetcsv和file_get_contents无法解析；上传后须move_uploaded_file至可读路径，注意xlsx/xls大小写、大文件内存优化、表头定位、空值与日期处理及编码容错。

thinkphp怎么处理excel导入_thinkphp读取表格数据方法【方法】

ThinkPHP 本身不内置 Excel 解析能力，必须依赖第三方库（如 phpoffice/phpspreadsheet）；直接用 $_FILES 接收后调用原生 PHP 文件操作读取 Excel 会失败——Excel 是二进制结构化格式，不是纯文本。

为什么不能用 `fgetcsv` 或 `file_get_contents` 直接读 Excel

Excel（.xlsx / .xls）是 ZIP 容器+XML/OLE 复合格式，fgetcsv 只能处理 CSV；file_get_contents 返回的是乱码二进制流，无法直接解析单元格。常见错误现象包括：ZipArchive::open(): Invalid or uninitialized Zip object、空数组、报错 Could not open ... for reading! File does not exist（路径没解压或权限不对）。

上传后的 Excel 文件在临时目录（如 /tmp/phpXXXXXX），需先 move_uploaded_file 到可读路径
phpspreadsheet 默认不支持 .xls（Excel 2003），需额外装 phpoffice/phpexcel（已废弃）或启用 PhpOffice\PhpSpreadsheet\Reader\Xls
大文件（>5MB）容易触发 memory_limit 超限，建议用 setReadDataOnly(true) 跳过样式解析

ThinkPHP 6.x 中集成 `phpspreadsheet` 的最小可行步骤

使用 Composer 安装并手动加载 Reader，避免框架自动扫描导致性能损耗：

Excel Export

从结构化JSON生成精美的.xlsx工作簿，支持多工作表、冻结表头、筛选、类型化列、公式、合计以及法国/摩洛哥格式。

下载

composer require phpoffice/phpspreadsheet

在控制器中按需引入（不全局 use）：

use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Reader\Xlsx;

接收上传：$file = $this->request->file('excel');，检查 $file->validate(['size'=>1024*1024*10, 'ext'=>'xlsx,xls'])
移动文件：$savePath = WRITE_PATH . 'uploads/' . date('Ymd') . '/'; @mkdir($savePath, 0755, true); $fileName = $file->move($savePath);
读取数据：$reader = IOFactory::createReader('Xlsx'); $spreadsheet = $reader->load($savePath . $fileName->getSaveName()); $sheet = $spreadsheet->getActiveSheet(); $data = $sheet->toArray();
注意：IOFactory::createReader() 的参数必须是大写字符串 'Xlsx' 或 'Xls'，小写会报 Reader not found

如何安全跳过 Excel 表头并校验必填字段

直接 array_shift($data) 不可靠——用户可能删了首行、或多表头合并。应显式定位起始行：

用 $sheet->getCell('A1')->getValue() 读第一单元格判断是否为预期标题（如 '用户名'），再用 $sheet->getHighestRow() 算总行数
遍历从第 2 行开始：for ($row = 2; $row getCell("A{$row}")->getValue(); }
空单元格返回 null 或 ''，需用 is_null() + trim() === '' 双重判断，避免把数字 0 当空
日期列默认被转成 Excel 序列号（如 44562），要用 PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($value) 转 PHP DateTime