如何让ThinkPHP在处理文件时兼容不同操作系统的文件名大小写问题？

本文共计1097个文字，预计阅读时间需要5分钟。

ThinkPHP默认使用`$FILES['file']['name']`获取原始文件名，但Windows不区分大小写，用户上传的`Report.PDF`和`report.pdf`会被视为同一文件；而Linux文件系统区分大小写，一旦保存路径依赖原始大小写（如生成URL或数据库记录），后续按小写路径访问将导致404错误。

关键不是“怎么存”，而是“怎么保真”——必须在上传瞬间就提取并保留原始大小写信息，不能等后续逻辑再猜。

• 别用 pathinfo($file['name'], PATHINFO_FILENAME) 做二次解析，它在 Windows 下可能已失真
• 直接使用 $_FILES['file']['name'] 原始值，但需立即做标准化处理（如转小写存 DB、保留原值存文件系统）
• 若需 URL 可访问，建议统一转小写保存 + 建立大小写映射表，或用哈希名替代原始名（更安全）

ThinkPHP 6 的 File 类自动转换文件名大小写

TP6 的 think\File 在调用 move() 时，默认会调用 getSaveName()，而该方法内部用了 md5_file() + 时间戳生成文件名——看起来规避了问题，但如果你重写了 getSaveName() 并拼接了原始 $file->getClientOriginalName()，就又掉回坑里了。