ThinkPHP中Excel导入需安装phpspreadsheet并执行dump-autoload，正确引入类，安全接收文件后按格式选择Reader加载，逐行读取过滤空行，映射字段清洗数据，最后事务分批入库。
ThinkPHP项目里要让用户上传Excel文件并把数据存进数据库，不是点几下鼠标就能完成的事——你得先装对库、写对类引用、处理好临时文件路径，再逐行读取、清洗、映射字段，最后批量入库。漏掉任何一环，轻则报错Class not found，重则内存爆掉或数据错位。
安装phpspreadsheet并验证可用性
执行命令安装最新稳定版（TP6要求PHP≥7.2，phpspreadsheet≥1.25）：
composer require phpoffice/phpspreadsheet
安装后立刻执行：
composer dump-autoload
【不执行这一步，90%的Class not found错误就出在这里】
立即学习“PHP免费学习笔记（深入）”；
在控制器顶部引入核心类：
use PhpOffice\PhpSpreadsheet\IOFactory;
use PhpOffice\PhpSpreadsheet\Reader\Xlsx;
use PhpOffice\PhpSpreadsheet\Reader\Xls;
别写错命名空间——漏掉PhpOffice\前缀或大小写混用，都会直接报错。
安全接收并转移上传文件
第一步：用ThinkPHP内置上传方法获取文件对象：
$file = $this->request->file('excel');
第二步：立刻调用$file->getRealPath()拿到真实临时路径——【千万别用$file->getPathname()，那是客户端原始路径，服务端根本打不开】
第三步：创建可读目录并移动文件：
mkdir(runtime_path() . 'upload/excel/', 0755, true);
move_uploaded_file($file->getRealPath(), $targetPath = runtime_path() . 'upload/excel/' . uniqid() . '.xlsx');
第四步：校验扩展名，仅允许.xlsx和.xls：
$ext = strtolower(pathinfo($targetPath, PATHINFO_EXTENSION));
if (!in_array($ext, ['xlsx', 'xls'])) { throw new \Exception('仅支持.xlsx和.xls格式'); }
按格式选择Reader并加载工作表
方法一：显式指定Xlsx Reader（推荐用于.xlsx文件）
$reader = new Xlsx();
$reader->setReadDataOnly(true); // 关键：跳过样式和公式，提速且防内存溢出
$spreadsheet = $reader->load($targetPath);
方法二：显式指定Xls Reader（专用于.xls旧格式）
$reader = new Xls();
$reader->setReadDataOnly(true);
$spreadsheet = $reader->load($targetPath);
方法三：用IOFactory自动探测（不推荐新手用）
只在明确知道文件类型时才用IOFactory::createReader('Xlsx')，传错类型会抛Invalid reader异常。
逐行读取并过滤空行
第一步：获取当前活动工作表：
$worksheet = $spreadsheet->getActiveSheet();
第二步：使用行迭代器遍历，避免toArray()吃光内存：
foreach ($worksheet->getRowIterator(2) as $row) { // 从第2行开始，跳过表头
第三步：获取单元格迭代器并启用稀疏模式：
$cellIterator = $row->getCellIterator();
$cellIterator->setIterateOnlyExistingCells(false); // 必须设为false，否则合并单元格会漏数据
第四步：收集本行值，并过滤全空行：
$rowData = [];
foreach ($cellIterator as $cell) {
$rowData[] = $cell->getValue();
}
if (empty(array_filter($rowData, function($v) { return is_string($v) ? trim($v) !== '' : !is_null($v); }))) { continue; } // 跳过纯空格、null或空字符串组成的行
第五步：将清洗后的行数据压入总数组：
$data[] = $rowData;
字段映射与数据清洗
先读取第一行作为表头：
$headerRow = $worksheet->getRowIterator(1)->current();
$headers = [];
foreach ($headerRow->getCellIterator() as $cell) {
$headers[] = trim((string)$cell->getValue());
}
硬编码映射规则（示例）：
$map = [
'用户姓名' => 'user_name',
'手机号' => 'mobile',
'状态' => 'status',
];
遍历$data每一行，按$header顺序提取值，再转成关联数组：
foreach ($data as $row) {
$record = [];
foreach ($headers as $i => $header) {
$key = $map[$header] ?? null;
if ($key && isset($row[$i])) {
$val = $row[$i];
// 处理“是/否”转1/0
if ($header === '状态') { $val = in_array($val, ['是', '启用', 1], true) ? 1 : 0; }
$record[$key] = $val;
}
}
$cleaned[] = $record;
}
事务批量插入数据库
开启事务：
$db = Db::connect();
$db->startTrans();
分批插入（每500条提交一次）：
foreach (array_chunk($cleaned, 500) as $chunk) {
try {
Db::name('user')->insertAll($chunk);
} catch (\Exception $e) {
$db->rollback();
throw $e;
}
}
提交事务：
$db->commit();
