FastAdmin Excel 批量导入方案|先预览校验、临时文件中转,解决 POST 超长限制,支持 10000 + 条数据导入

前端上传Excel文件    ↓后端接收文件，移动到临时目录，生成唯一导入token    ↓后端读取临时Excel，解析+字段校验    ↓返回预览数据给前端渲染（用于展示，前端不保存全量数据）    ↓管理员复核页面，查看标红错误行    ↓点击【确认导入】，仅提交token（短字符串）    ↓后端通过token找到临时文件，再次读取Excel，分块事务入库    ↓入库成功后删除临时文件；超时自动清理过期临时文件

composer require phpoffice/phpspreadsheet

memory_limit = 512Mmax_execution_time = 300

<aclass="btn btn-success btn-import"><iclass="fa fa-upload"></i> 批量导入Excel</a>

$('.btn-import').on('click',function(){    Fast.api.open('demo/import/upload','上传Excel导入',{width:500,height:300})});

// 预览弹窗渲染表格，标记错误行function showPreview(data){    var importToken = data.token; // 拿到临时文件标识    var list = data.list;    var html = '<table class="layui-table">';    html += '<thead><tr><th>姓名</th><th>手机号</th><th>金额</th><th>状态</th></tr></thead><tbody>';    $.each(list,function(i,row){        var errClass = row.is_error ? 'style="background:#ffecec"' : '';        html += `<tr ${errClass}>            <td>${row.name}</td>            <td>${row.mobile}</td>            <td>${row.money}</td>            <td>${row.err_msg||'正常'}</td>        </tr>`;    })    html += '</tbody></table>';    layer.confirm(html,{title:'预览数据（共'+data.total+'条）',area:['80%','70%']},function(index){        // ✅ 关键：只传token，不再传全部rows数组        Fast.api.ajax({            url:'demo/import/save',            data:{token: importToken}        },function(res){            Toastr.success('导入完成！成功：'+res.success+'条，失败：'+res.fail+'条');            table.bootstrapTable('refresh');            layer.close(index);        })    })}

<?phpnamespace app\demo\controller;use PhpOffice\PhpSpreadsheet\IOFactory;use think\Controller;use think\facade\Cache;classImportextendsController{    // 临时文件根目录    protected $tempPath = RUNTIME_PATH . 'importtemp/';    public functioninitialize()    {        parent::initialize();        if (!is_dir($this->tempPath)) {            mkdir($this->tempPath, 0755, true);        }        // 顺便清理2小时前的过期临时文件        $this->clearExpireFile();    }    // 上传Excel，生成临时文件，返回预览数据+token    public functionupload()    {        $file = $this->request->file('file');        if(!$file){            $this->error('请上传Excel文件');        }        $info = $file->validate(['ext'=>'xlsx,xls'])->move($this->tempPath);        if(!$info){            $this->error($file->getError());        }        // 生成唯一token        $token = md5(uniqid(mt_rand(),true));        $tempFile = $info->getRealPath();        // 缓存token和真实文件路径，有效期2小时        Cache::set('import_'.$token, $tempFile, 7200);        // 读取Excel，解析校验，返回预览        $spreadsheet = IOFactory::load($tempFile);        $sheet = $spreadsheet->getActiveSheet();        $rows = $sheet->toArray();        $list = [];        foreach ($rows as $k=>$v){            if($k == 0) continue; //跳过表头            $row = [                'name'  => trim($v[0]??''),                'mobile'=> trim($v[1]??''),                'money' => floatval($v[2]??0),                'is_error' => false,                'err_msg'  => ''            ];            //字段校验            if(empty($row['name'])){                $row['is_error'] = true;                $row['err_msg'] = '姓名不能为空';            }            if(!preg_match('/^1[3-9]\d{9}$/',$row['mobile'])){                $row['is_error'] = true;                $row['err_msg'] = '手机号格式错误';            }            $list[] = $row;        }        $this->success('解析成功',[            'token'=>$token,            'list'=>$list,            'total'=>count($list)        ]);    }

    // 确认入库，只接收token    public functionsave()    {        $token = $this->request->post('token','');        if(empty($token)) $this->error('导入标识缺失');        $tempFile = Cache::get('import_'.$token);        if(!$tempFile || !is_file($tempFile)){            $this->error('文件已过期或者不存在，请重新上传');        }        $spreadsheet = IOFactory::load($tempFile);        $sheet = $spreadsheet->getActiveSheet();        $rows = $sheet->toArray();        $success = 0;        $fail = 0;        $insertAllData = [];        $model = new \app\demo\model\User();        foreach ($rows as $k=>$v){            if($k == 0) continue;            $name  = trim($v[0]??'');            $mobile= trim($v[1]??'');            $money = floatval($v[2]??0);            //同样校验            if(empty($name) || !preg_match('/^1[3-9]\d{9}$/',$mobile)){                $fail++;                continue;            }            $insertAllData[] = [                'name'=>$name,                'mobile'=>$mobile,                'money'=>$money,                'createtime'=>time()            ];            $success++;        }        // 分批入库，每批500条        $chunkList = array_chunk($insertAllData,500);        foreach ($chunkList as $chunk){            $model->startTrans();            try{                $model->insertAll($chunk);                $model->commit();            }catch (\Exception $e){                $model->rollback();                $fail += count($chunk);                $success -= count($chunk);            }        }        //导入完成，清理缓存+删除临时文件        Cache::delete('import_'.$token);        @unlink($tempFile);        $this->success('导入完成',compact('success','fail'));    }

    // 清理超过2小时的临时文件    protected functionclearExpireFile()    {        $files = glob($this->tempPath.'*.{xlsx,xls}',GLOB_BRACE);        $expireTime = time() - 7200;        foreach ($files as $file){            if(is_file($file) && filemtime($file) < $expireTime){                @unlink($file);            }        }    }