moveTo() 返回服务器绝对物理路径，如/var/www/html/runtime/upload/20240510/test.jpg，不可直接用于前端访问；应存至public/uploads等Web可访问目录，并存相对路径供URL拼接。
ThinkPHP 6 的 moveTo() 返回的是什么路径
它返回的是服务器上的绝对物理路径，不是 URL 路径。比如 /var/www/html/runtime/upload/20240510/test.jpg —— 这个路径你不能直接拼到域名后面访问，浏览器会 404。
常见错误是拿到 moveTo() 的返回值就存进数据库、或直接 echo 给前端，结果前端无法加载图片。
- 正确做法：先明确文件最终要「怎么被访问」—— 是走静态资源目录（如
public/uploads/），还是走控制器路由（如/index.php?s=/upload/get/id/123） - 如果走静态目录，
moveTo()应该指定到public/uploads/下的子路径，例如：$file->move(public_path('uploads') . '/images/', $filename) - 移动后，数据库里存相对路径（如
uploads/images/test.jpg），前端拼上https://yoursite.com/即可访问
为什么不能把文件存在 runtime/ 目录下并直接访问
runtime/ 是 ThinkPHP 的运行时缓存目录，默认不开放 Web 访问权限。Nginx/Apache 通常已配置禁止访问该目录下的文件，直接请求会返回 403 或 404。
即使你临时改了 Web 服务器配置放行，也不推荐：因为 runtime/ 可能被 php think clear:all 清空，上传的文件就丢了。
立即学习“PHP免费学习笔记（深入）”；
- 必须区分「存储位置」和「可访问位置」：上传逻辑可以写在控制器里，但落盘路径得是 Web 可达的目录（如
public/下） - 若需权限控制（比如只让登录用户下载私有文件），才考虑用控制器中转，此时文件可存在
runtime/或storage/，但访问必须走response()->download()或流式输出 - ThinkPHP 6.1+ 提供
think\Filesystem，配合local驱动时，writeStream()写入的路径也默认落在runtime/，同样不可直链
request()->file() 之后怎么安全地构造可访问 URL
核心原则：URL 路径 ≠ 文件系统路径。你需要自己约定好「上传后存放的 Web 公共子目录」，再基于它生成 URL。
- 推荐固定上传根目录为
public/uploads/，代码中统一用public_path('uploads')获取物理路径 - 生成 URL 时不要硬编码域名，用
url()或request()->domain()+ 相对路径，例如：request()->domain() . '/uploads/images/' . $filename - 注意 Windows 和 Linux 路径分隔符差异，
public_path()已处理，但手拼路径时别用\ - 如果启用了 URL 重写（如隐藏
index.php），确保.htaccess或 Nginx 配置没把/uploads/请求误导向框架入口
多环境部署时路径容易出错的关键点
开发机（Windows）、测试机（Linux Docker）、生产机（Nginx + PHP-FPM）三者之间，public_path() 返回的路径一致，但 Web 服务器能否真实映射到该目录，取决于配置。
- Nginx 示例中必须包含
root /var/www/html;，且location /uploads/不能额外加alias导致路径重复解析 - 使用 Docker 时，宿主机挂载的
public/uploads目录，容器内权限要设为 www-data 可写（chmod -R 755不够，得chown -R www-data:www-data） - ThinkPHP 的
app_debug = true下，部分异常会暴露物理路径，上线前务必关掉，避免泄露服务器结构
路径问题本质是「文件在哪存」和「用户从哪取」两件事没对齐。只要守住 public 目录边界、不碰 runtime、不拼错 URL，基本不会掉坑里。
