ThinkPHP如何配置修改上传文件路径_按日期生成子目录存放

先说一个很多人踩过的坑：费了半天劲改rootPath，结果文件还是存到了原来的目录。其实，这完全是搞混了rootPath和sa vePath的分工。

ThinkPHP 上传路径配置中 rootPath 和 sa vePath 的区别

rootPath 是物理存储的根目录，框架默认指向 public/uploads。真正决定文件存到哪一层子目录的关键，是 sa vePath。它支持动态值，比如 date('Ym/d') 就能实现按年月日分层的效果。

一个很常见的错误是：把日期逻辑直接写死在配置文件里。结果就是，不管哪次上传，文件都被塞进同一个路径。正确的做法，是在调用 move() 之前动态计算出 sa vePath，或者通过闭包传进去。

• rootPath 是物理根目录，建议保持默认，免得和 Web 访问路径对不上
• sa vePath 是相对于 rootPath 的子路径，支持变量和函数返回值
• 如果用了 validate(['size'=>1024*1024])，这个验证必须在 move() 之前完成，否则 sa vePath 的动态逻辑可能不生效

ThinkPHP 6.x 中使用闭包动态生成上传子目录

官方推荐的方式是：在 move() 方法的第二个参数传入一个闭包，闭包内部返回带日期的路径字符串。这个闭包会自动接收一个 File 对象，你可以从中拿到原始文件名、后缀等信息。

$file = $this->request->file('image');$sa vePath = $file->move( 'uploads', function($file) {    return date('Ym') . '/' . date('d') . '/';});

注意一点：move() 的第一个参数是 rootPath 下的相对路径（比如 uploads），不是完整路径。闭包返回的才是最终的子目录，结尾没加斜杠也没关系，框架会自动补上。

• 闭包内调用 date() 是安全的，每次上传都会重新执行，没问题
• 不要在闭包里拼接 rootPath，框架已经帮你处理好层级关系了
• 如果还想按用户 ID 再分一层，可以写成 date('Ym') . '/u_' . $uid . '/' . date('d')

ThinkPHP 5.1 中通过配置数组设置动态 sa vePath

到了 5.1 版本，闭包这条路走不通了。得靠配置数组里的 sub_name，或者手动拼接 sa vePath。最稳的方式是先拿到当前日期，再自己组装路径：

$dateDir = date('Ym') . DS . date('d');$info = $file->move(ROOT_PATH . 'public' . DS . 'uploads', $dateDir);

这里的 DS 是系统的目录分隔符，ROOT_PATH 指向项目的根目录。所以实际存起来的路径就是 public/uploads/202406/15/xxx.jpg。需要确认 public/uploads 目录有写权限，不然会报错 move_uploaded_file(): Unable to move。

• 不能直接写 'uploads/'.date('Ym/d')，因为 move() 的第二个参数是子路径，不是完整路径
• sub_name 这个配置项只影响文件名的前缀，管不了目录结构
• 如果开启了 app_debug = false，目录创建失败不会抛异常，只会返回 null。所以记得主动检查一下 $info

Web 访问路径与物理路径不一致时的坑

按日期生成子目录后，前端访问图片的地址也得跟着更新。比如文件存在 public/uploads/202406/15/test.png，那 URL 就是 /uploads/202406/15/test.png。但很多人配置了 Nginx 别名或者 Apache 重写，结果路径映射就乱了。

最容易忽略的一点是：ThinkPHP 默认不会自动创建多级子目录。如果在 move() 的时候，202406/15 这个目录还不存在，就会报错 failed to open stream: No such file or directory。框架虽然有自带的 mkdir 逻辑，但在某些 PHP 版本或 SELinux 环境下，可能会静默失败。

• 上线前务必测试一下，首次上传时能不能自动建好 202406/15 这种嵌套目录
• 用 is_dir() 加上 mkdir($path, 0755, true) 手动做个兜底，更可靠
• CDN 的回源配置也要匹配新的路径规则，不然缓存下来全是 404