ThinkPHP导入Excel时图片需单独提取保存：先用$file->getRealPath()获取真实路径，显式指定Xls/Xlsx Reader类型，逐行遍历避免内存爆炸，再通过DrawingCollection解析坐标并保存图片至Web可访问目录，最后将路径写入对应单元格数据数组。
ThinkPHP导入Excel时，图片不随文本一起读出，必须单独提取并保存到服务器，再将路径写入对应单元格位置的数据数组中，否则数据库里只会存空值或报错。
上传后立即获取真实路径
接收上传文件后，第一行代码就必须调用 $file->getRealPath() 获取临时文件的真实路径。这个路径是 PHP 进程能真正打开的唯一地址，【不能用 $file->getPathname() 或 $_FILES['file']['tmp_name']】，后者在 ThinkPHP 后续流程中大概率已被清理，IOFactory::load() 会直接报 “File does not exist”。
如果项目部署在 Windows 且路径含中文，需用 mb_convert_encoding 转为 UTF-8 再传入；Linux 环境则要确认 /tmp 目录对 web 用户有读权限。
显式指定 Reader 类型加载文件
不要直接用 IOFactory::load()，它会自动探测格式但极易失败。先用 finfo_file() 检查真实 MIME 类型，再匹配创建 Reader：
立即学习“PHP免费学习笔记（深入）”；
→ 若是 .xls 文件，用 IOFactory::createReader('Xls')；
→ 若是 .xlsx 文件，用 IOFactory::createReader('Xlsx')；
传错类型会抛出 “Invalid reader” 异常，且 PHP 8+ 下不会静默降级。
逐行遍历避免内存爆炸
大文件（超过 2MB 或行数超 5000）禁用 $sheet->toArray()，它会把所有隐藏行、合并单元格残留、样式元数据全载入内存，一个 5MB Excel 可能吃掉 800MB 内存。
第一步：调用 $worksheet->getRowIterator() 获取行迭代器；
第二步：对每行调用 $row->getCellIterator()，并立刻执行 $cellIterator->setIterateOnlyExistingCells(true)，跳过空白单元格；
第三步：用 $row->getRowIndex() === 1 判断是否为表头行，别依赖数组下标 0——合并单元格会让索引错乱。
提取图片并写入对应单元格
方法一：遍历 DrawingCollection 获取图片信息
→ 执行 $sheet->getDrawingCollection() 得到所有图片对象；
→ 对每个 $img，用 Coordinate::coordinateFromString($img->getCoordinates()) 解析出列字母和行号；
→ 将列字母转为数字索引（如 “C” → 3），注意数组从 0 开始，所以最终列偏移为 $colIndex - 1；
→ 行号减 1 得到数组下标（Excel 行号从 1 开始，PHP 数组从 0 开始）；
→ 生成唯一文件名（推荐 md5(microtime(true))），按 MIME 类型保存为 jpg/gif/png；
→ 把图片相对路径写入 $data[$rowIndex][$colIndex] 中，覆盖原单元格内容。
方法二：提前建好图片目录并设权限
图片保存路径必须是 Web 可访问目录（如 public/uploads/images/），且 PHP 进程有写权限；【mkdir 第三个参数必须设为 true，否则嵌套目录创建失败】；
保存前检查 imagejpeg() 返回值，失败时记录日志并跳过该图，避免整个导入中断。
