ThinkPHP导入Excel需按版本选择方案：TP3.2/5.1用PHPExcel并手动import()，TP6必须用phpspreadsheet；须校验MIME类型与后缀，区分xls/xlsx加载器，推荐流式读取并规范空值处理。
在ThinkPHP项目中导入Excel文件时，直接调用PHPExcel类却报“Class not found”，不是框架缺类，而是未正确引入Vendor库路径或未处理命名空间兼容性；TP3.2/TP5.1需用import()手动加载，TP6必须用composer安装phpspreadsheet并写全命名空间。
确认ThinkPHP版本与PHPExcel适配方案
ThinkPHP 3.2和5.0系列不支持Composer自动加载第三方库，必须将PHPExcel放入Vendor目录并通过import()引入；ThinkPHP 6.x已全面转向PSR-4规范，【PHPExcel已彻底废弃，强行使用会导致DateTime解析失败、内存泄漏或类加载中断】，必须改用phpoffice/phpspreadsheet。
TP3.2项目请下载PHPExcel 1.8.2（最后稳定版），解压后完整放入ThinkPHP/Library/Vendor/PHPExcel；TP6项目执行composer require phpoffice/phpspreadsheet，确保PHP版本≥7.4。
TP5.1若仍用PHPExcel，需在配置文件中关闭composer自动加载冲突：在config/app.php里设置'auto_load' => false，否则vendor/autoload.php会覆盖Vendor目录扫描。
立即学习“PHP免费学习笔记（深入）”；
TP3.2中导入Excel的实操步骤
第一步：上传文件并校验格式
接收$_FILES['excel_file']后，先检查['type']是否为application/vnd.ms-excel或application/vnd.openxmlformats-officedocument.spreadsheetml.sheet，再用pathinfo($_FILES['excel_file']['name'], PATHINFO_EXTENSION)取真实后缀，仅允许xls和xlsx——【拒绝.csv后缀，PHPExcel无法识别纯文本CSV为Excel格式】。
第二步：移动临时文件到安全路径
调用ThinkPHP内置Upload类，设置rootPath => './Uploads/'、savePath => 'excel/'、exts => ['xls','xlsx']，成功后得到$file_path = $upload->rootPath . $info['excel_file']['savepath'] . $info['excel_file']['savename']。
第三步：加载PHPExcel并读取数据
根据后缀选择读取器：import("Vendor.PHPExcel.Reader.Excel5")对应xls，import("Vendor.PHPExcel.Reader.Excel2007")对应xlsx；实例化后调用$objReader->load($file_path)，再用$objPHPExcel->getSheet(0)->getRowIterator()逐行遍历，避免getHighestRow()在空行多时误判行数。
TP6中用phpspreadsheet安全导入Excel
方法一：基础流式读取（推荐用于≤5万行）
在控制器顶部声明use PhpOffice\PhpSpreadsheet\IOFactory;；上传验证通过后，用finfo_file(finfo_open(FILEINFO_MIME_TYPE), $filePath)二次校验真实MIME类型，仅放行application/vnd.ms-excel和application/vnd.openxmlformats-officedocument.spreadsheetml.sheet。
创建读取器：$reader = IOFactory::createReader('Xlsx');（xls用'Xls'），然后$spreadsheet = $reader->load($filePath);；获取活动表$worksheet = $spreadsheet->getActiveSheet();，用$worksheet->getRowIterator()循环，对每行调用$cellIterator->setIterateOnlyExistingCells(false)确保读取空白单元格值为null。
方法二：大文件分块读取（适用于10万行以上）
不用load()整页加载，改用$reader->setReadDataOnly(true)跳过样式解析；读取前先用$worksheet->getHighestRow()估算总行数，再按每2000行切片：for ($startRow = 1; $startRow ；每次切片处理完调用<code>gc_collect_cycles()释放内存，防止OOM崩溃。
这一步操作起来很简单，直接把文件拖进去就行。
字段映射与数据清洗关键动作
Excel表头是中文如“用户姓名”，数据库字段却是user_name；某列填了“是/否”，但数据库是tinyint(1)。不做映射直接插，要么字段错位，要么触发SQL错误。
先提取首行作为表头数组：$headers = array_map('trim', $data[1] ?? []);，建立映射关系：$map = ['用户姓名'=>'user_name', '是否启用'=>'status'];；遍历后续行时，用array_combine($map, $rowData)重组键名；对“是/否”列，统一转为1/0：$cleaned['status'] = in_array($raw['是否启用'], ['是','YES','Y'], true) ? 1 : 0;。
空值处理不能只靠empty()，因为Excel里字符串"0"、"false"会被判定为空；改用!is_null($val) && $val !== ''判断真实非空。
