ThinkPHP导入Excel时需显式指定Reader类型并验证文件真实类型：先用pathinfo获取扩展名映射Xlsx/Xls，再用finfo_open检测MIME；立即调用getRealPath()防临时路径失效；启用setReadDataOnly(true)、getRowIterator()及分块读取优化内存；日期和数字需按数据类型与格式码转换。
ThinkPHP导入Excel时遇到.xlsx文件打不开、报Invalid reader或空数组，本质是新版Excel（.xlsx）与旧版（.xls）格式不兼容，且PhpSpreadsheet默认不自动识别后缀伪装或无扩展名文件。
确认文件真实类型并显式指定Reader
第一步：用pathinfo提取上传文件原始扩展名，而非依赖$_FILES['file']['name']的用户输入值——浏览器可任意伪造后缀，如把.xls改名为.xlsx上传，导致createReader('Xlsx')失败。
第二步：根据扩展名映射Reader类型，严格区分大小写：【'xlsx' → 'Xlsx'，'xls' → 'Xls'】。注意Xls类需额外启用，若未安装phpoffice/phpspreadsheet的完整依赖，调用createReader('Xls')会直接Fatal error。
第三步：若扩展名为空或不可信（如拖拽上传无后缀），改用finfo_open()检测MIME类型：application/vnd.openxmlformats-officedocument.spreadsheetml.sheet对应Xlsx，application/vnd.ms-excel对应Xls。
立即学习“PHP免费学习笔记（深入）”；
绕过临时路径失效问题
ThinkPHP上传后，$file->getPathname()返回的/tmp/phpXXXXXX路径在请求结束前可能已被清理，IOFactory::load()调用时文件已不存在。
必须立即调用$file->getRealPath()获取真实可读路径，且该操作要在接收文件后第一行代码执行。
如果getRealPath()返回false，说明文件未成功落盘，此时应终止流程并提示“文件上传异常”，不要尝试用getPathname()兜底——那只会让错误延迟到IOFactory报错时才暴露。
流式加载防内存爆炸
方法一：禁用样式解析，大幅降低内存占用
在创建Reader后立即调用$reader->setReadDataOnly(true)，跳过字体、边框、合并单元格等渲染信息。这对纯数据导入场景足够，且能将10MB文件的内存峰值从600MB压至80MB以内。
方法二：启用只读迭代器，逐行处理
不用getActiveSheet()->toArray()，改用$worksheet->getRowIterator()→遍历每行→再用getCellIterator()遍历每列。关键要加$cellIterator->setIterateOnlyExistingCells(true)，否则空白单元格仍被实例化，内存不降反升。
方法三：对超大文件（>20MB）启用分块读取
设置$reader->setLoadAllSheets(false)→仅加载首工作表→用$spreadsheet->getSheetByName('数据表')精准定位→避免加载隐藏表或图表页浪费内存。
修复日期和数字乱码
Excel中“2025-03-15”实际存储为序列号45721，PhpSpreadsheet默认返回该数字而非日期字符串；科学计数法数字如1.23456789E+10也需还原为整型。
先判断单元格数据类型：$cell->getDataType() === \PhpOffice\PhpSpreadsheet\Cell\DataType::TYPE_NUMERIC。
再结合样式格式码识别是否为日期：$cell->getStyle()->getNumberFormat()->getFormatCode()匹配'date'、'datetime'、'yyyy-mm-dd'等模式，匹配成功则用\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($cell->getValue(), $timezone)转换。
对纯数字字段，用intval($cell->getValue())或number_format($cell->getValue(), 0, '', '')清除科学计数法干扰，【注意：不能用(int)强转，会截断超大整数】。
