必须安装phpspreadsheet并正确配置命名空间、mime校验、流式读取、字段映射与分批事务，才能安全导入excel数据至数据库。
用户上传Excel文件后，系统需在不崩溃、不报错、不丢数据的前提下，把内容准确写入数据库。这要求你避开自动加载失败、内存溢出、字段错位、格式误判四大雷区。
安装并验证phpspreadsheet组件
执行composer require phpoffice/phpspreadsheet安装最新稳定版；TP6项目必须确保PHP版本≥7.4，否则类无法加载。
在控制器顶部写use PhpOffice\PhpSpreadsheet\IOFactory;——【漏掉PhpOffice\前缀必报Class not found】，这是90%新手卡住的第一步。
新建测试方法，直接new IOFactory()会报错，正确写法是调用静态方法：IOFactory::createReader('Xlsx');，能成功返回Reader实例即表示安装与命名空间无误。
安全接收并校验上传文件
别信$_FILES['file']['type']，它由浏览器伪造，完全不可靠。
用finfo_file(finfo_open(FILEINFO_MIME_TYPE), $_FILES['file']['tmp_name'])获取真实MIME类型，只允许application/vnd.openxmlformats-officedocument.spreadsheetml.sheet（xlsx）和application/vnd.ms-excel（xls）。
同时用pathinfo($_FILES['file']['name'], PATHINFO_EXTENSION)取扩展名，转大写后映射为reader类型：'xlsx' → 'Xlsx'，'xls' → 'Xls'；【拒绝.csv文件，phpspreadsheet默认不支持CSV读取，会直接抛出异常】。
将临时文件移动到public/uploads/excel/目录并生成唯一文件名，确保路径可被PHP进程读取。
流式读取Excel避免内存爆炸
第一步：用$reader = IOFactory::createReader($readerType);显式创建reader，比IOFactory::load()更稳更快。
第二步：调用$reader->setReadDataOnly(true)关闭样式、公式、注释解析，内存占用直降60%以上。
第三步：加载工作簿后获取首张工作表：$spreadsheet = $reader->load($filePath); $worksheet = $spreadsheet->getActiveSheet();
第四步：启用行迭代器分块读取，每次只处理500行：foreach ($worksheet->getRowIterator(1, 500) as $row) { ... }，读完立即unset($row)释放对象引用。
第五步：遍历单元格时强制包含空单元格：$cellIterator->setIterateOnlyExistingCells(false)，否则列序会错位，导致“姓名”写进“手机号”字段。
清洗数据并映射字段
读取第一行作为表头，硬编码映射规则，例如：['用户姓名' => 'user_name', '注册时间' => 'created_at', '是否启用' => 'status']。
对“是否启用”这类中文枚举值做转换：$value === '是' ? 1 : ($value === '否' ? 0 : null)，避免插入字符串触发tinyint字段截断警告。
日期列若为Excel序列值（如44835），需用\PhpOffice\PhpSpreadsheet\Shared\Date::excelToDateTimeObject($value)转为DateTime对象，再格式化为Y-m-d H:i:s字符串。
跳过全空行：if (!array_filter($rowData)) continue;，防止因Excel末尾隐藏空行导致插入NULL记录。
分批插入并控制事务
方法一：用Db::name('users')->insertAll($chunk)，字段名必须与数据库列名完全一致，不走模型验证和事件钩子，速度最快。
方法二：用UserModel::saveAll($chunk, ['validate' => false])，适合已清洗干净但需自动填充create_time等时间戳字段的场景。
无论选哪种，都必须切片：$chunks = array_chunk($cleanData, 300);，每批300条——MySQL默认max_allowed_packet=4M，超量会报Packet too large错误。
每批插入前手动开启事务：Db::startTrans();，成功后Db::commit();，失败则Db::rollback();，确保部分失败不污染已有数据。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
