thinkphp8.0上传文件默认使用随机字符串+原扩展名，不保留原始文件名；自定义命名须用字符串或闭包设置savename，禁用旧版数组语法，推荐闭包结合时间戳、uniqid与清洗后的原文件名生成唯一安全文件名。
ThinkPHP8.0 上传后的文件名默认是随机字符串 + 原扩展名，不保留原始文件名；若需自定义命名规则，必须显式设置 saveName 属性，且不能依赖旧版 ThinkPHP 的数组写法（如 ['uniqid', '']）。
ThinkPHP8.0 的 saveName 不再支持数组语法
旧版 ThinkPHP（如 3.x/5.x）中常用 $upload->saveName = ['uniqid', '']; 或 ['md5', 'time'] 来控制命名逻辑，但在 TP8 中该写法已失效，会直接报错或静默忽略。
-
saveName在 TP8 中只接受字符串或闭包（Closure）类型 - 字符串值会被当作固定文件名（如
'avatar.jpg'），不推荐用于多文件场景 - 真正可控的方式是传入闭包，接收
UploadFile对象并返回字符串 - 闭包内可安全使用
pathinfo($file->getOriginalName(), PATHINFO_EXTENSION)获取原后缀
如何用闭包实现「时间戳+随机数+原文件名」组合命名
这是最贴近业务需求的常见做法：既避免重名，又保留语义（比如 20260510102345_abc7d8_profile.jpg）。
- 闭包必须返回纯字符串，不能含路径、不能含非法字符（如中文、空格、斜杠）
- 建议对原文件名做
mb_substr($name, 0, 32)截断，防止过长 - 推荐用
uniqid('', true)替代简单rand()，降低碰撞概率 - 示例代码：
$upload->saveName = function ($file) {
$ext = pathinfo($file->getOriginalName(), PATHINFO_EXTENSION);
$name = mb_substr(pathinfo($file->getOriginalName(), PATHINFO_FILENAME), 0, 32);
$name = preg_replace('/[^\w\-\.]/', '_', $name); // 清洗非法字符
return date('YmdHis') . '_' . uniqid('', true) . '_' . $name . '.' . strtolower($ext);
};
TP8 文件上传类不自动处理中文文件名，必须手动转义
如果用户上传了 我的头像.jpg，默认行为下 getOriginalName() 返回的就是原始 UTF-8 字符串。直接拼进文件系统会导致保存失败（Linux 下常见 failed to open stream: Invalid argument）。
- 不要用
iconv()或mb_convert_encoding()强转 GBK —— 这在容器或不同 locale 环境下极不稳定 - 更可靠的做法是彻底弃用原名，仅取哈希或时间戳，或用拼音转换（需引入第三方库如
overtrue/pinyin） - 若坚持保留语义，至少用
urlencode()包裹文件名主体（但注意 URL 解码后仍可能超长） - TP8 的
UploadFile类本身不提供内置转拼音或 slug 化方法，这点和 Laravel 的storeAs()不同
上传后获取完整路径时，info 数组里的 savepath 和 savename 是分离的
TP8 返回的 $info 是一个二维数组，每个上传项包含 savepath（相对路径）、savename（纯文件名）、name（原始名）等键。拼成绝对路径得靠自己组合，框架不提供 getRealPath() 这类便捷方法。
-
savepath默认是''（空字符串），不是'./'或'Uploads/'，它只反映savePath配置值 - 实际物理路径 =
rootPath . savePath . savename，其中rootPath默认是ROOT_PATH . 'public' . DIRECTORY_SEPARATOR . 'uploads' - 别硬编码拼接，应通过
App::getRootPath()+ 配置项动态计算，否则部署到子目录或 CLI 环境会出错 - 如果你把
rootPath设为ROOT_PATH . 'runtime' . DIRECTORY_SEPARATOR . 'upload'，那savepath就不该再设成'temp/'，否则路径变成runtime/upload/temp/xxx.jpg—— 容易被误删
真正容易被忽略的是：TP8 的上传类不会自动创建深层目录（比如 savePath = 'user/avatar/2026/05/'），mkdir 权限失败时只抛出警告而非异常，导致后续 move_uploaded_file() 失败却返回空 $info，错误信息也只显示 "上传失败"，没具体原因。务必在调用 upload() 前检查并确保目录可写。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
