thinkphp导入excel必须指定上传临时目录，tp6需修改filesystem.php中local磁盘root路径或新增excel_import磁盘，tp5则配置application/config.php中upload.save_path；版本不匹配会导致配置失效。
ThinkPHP项目中导入Excel文件时，必须明确指定上传临时目录，否则会因路径未定义导致上传失败或文件写入系统临时目录引发权限问题。
确认ThinkPHP版本并定位配置文件位置
ThinkPHP 6.x 使用 app/config/filesystem.php 管理文件上传行为；ThinkPHP 5.1/5.2 则在 application/config.php 中的 'upload' 键下配置。请先执行 php think version 查看当前版本，再打开对应配置文件。
若误用 TP5 的配置方式修改 TP6 项目，【upload 配置将完全被忽略】，因为 TP6 已废弃全局 upload 配置项，改由 Flysystem 驱动统一接管。
TP6 设置 Excel 上传目录（推荐方式）
方法一：修改 filesystem.php 中的 local 磁盘配置
找到 'local' => [ 'type' => 'local', 'root' => runtime_path() . 'upload' ] 这一行，把 runtime_path() . 'upload' 替换为绝对路径，例如：__DIR__ . '/../../public/uploads/excel'。
注意：该目录必须已存在且 Web 服务器用户（如 www-data 或 nginx）有写入权限，否则上传会静默失败。
方法二：单独为 Excel 创建专用磁盘
在 filesystem.php 的 'disks' 数组末尾新增一项：
'excel_import' => [ 'type' => 'local', 'root' => public_path() . '/uploads/excel', 'url' => '/uploads/excel' ]
这一步完成后，控制器中调用时需显式指定磁盘名：$file->store('temp', 'excel_import')，避免和其他上传混用路径。
TP5.1/5.2 手动配置 upload 目录
第一步：打开 application/config.php
第二步：在 return 数组中添加或修改 upload 配置块：
'upload' => [ 'mimes' => [], 'size' => 1024 * 1024 * 50, 'exts' => ['xlsx', 'xls'], 'auto_rename' => true, 'subdir' => 'excel/' . date('Ymd'), 'save_path' => '../public/uploads/' ]
其中 'save_path' 必须是相对于入口文件（如 public/index.php）的路径，不能写成绝对路径或带 ./ 前缀，否则 ThinkPHP 内部拼接时会出错。
第三步：确保 public/uploads/ 目录存在且可写，子目录（如 excel/20260708）会在上传时自动创建。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
