ThinkPHP绑定域名后上传文件存储路径问题 ThinkPHP自定义域名映射-ThinkPHP-PHP中文网

thinkphp换域名后上传路径错乱，因$_server['document_root']与实际项目根目录不一致，应改用public_path('uploads')等可靠路径构造方式，并避免混用storage_path()与public_path()。

thinkphp绑定域名后上传文件存储路径问题 thinkphp自定义域名映射

上传文件路径为什么在换域名后变乱了

ThinkPHP 默认用 $_SERVER['DOCUMENT_ROOT'] 拼接上传保存路径，但自定义域名映射（比如 Nginx 里用 root 指向非默认站点目录）会导致 DOCUMENT_ROOT 和实际项目根目录不一致。结果就是 think\facade\Filesystem::put() 或 move_uploaded_file() 写到错地方，甚至权限失败。

常见错误现象：file_put_contents(): failed to open stream: No such file or directory，或文件明明上传成功却找不到——其实存到了 Nginx 的 root 目录下，而非 ThinkPHP 项目里的 public/uploads。

确认当前 DOCUMENT_ROOT 值：在控制器里临时加 var_dump($_SERVER['DOCUMENT_ROOT']);，对比你期望的项目根目录（如 /var/www/myapp）是否一致
ThinkPHP 6+ 推荐统一用 app()->getRuntimePath() 或 public_path('uploads') 构建路径，而不是拼接 $_SERVER
如果用了自定义存储驱动（如本地 disk），检查 config/filesystems.php 中 'root' 配置项是否写死绝对路径；应改用 public_path('uploads') 或 runtime_path('uploads')

自定义域名映射下 public_path() 返回路径不准

public_path() 底层依赖 App::getRootPath() 和 DS . 'public'，而 getRootPath() 默认从 __DIR__ 反推，一般没问题。但如果你把入口文件 public/index.php 移动过、或用软链接部署、或 Nginx 的 alias 指令替代 root，就可能让 public_path() 返回的物理路径和 Web 可访问路径错位。

典型表现：图片 URL 能访问（https://xxx.com/uploads/abc.jpg），但代码里用 public_path('uploads/abc.jpg') 找不到文件，因为返回的是 /var/www/vhost1/public/uploads/...，而真实文件在 /var/www/myapp/public/uploads/...。

不要靠猜测路径，直接在控制器里打印 echo public_path(); 和 echo __DIR__; 对比
若发现偏差，手动覆盖 public 目录路径：在 bootstrap/app.php 开头加 App::usePublicPath('/var/www/myapp/public');
避免用 alias 映射整个 public 目录；优先用 root /var/www/myapp; + location / { try_files $uri $uri/ /index.php?$query_string; }

多域名共用同一套代码时上传目录隔离怎么做

一个 ThinkPHP 项目绑了 user.example.com 和 admin.example.com，但你希望用户上传走 public/uploads/users/，后台上传走 public/uploads/admins/——不能只靠域名判断再拼路径，否则容易绕过、难维护。

关键点在于：ThinkPHP 的文件上传逻辑本身不感知域名，所有隔离必须在业务层显式控制，且要避开 $_SERVER['HTTP_HOST'] 被伪造的风险。

在中间件或基类控制器中，根据可信配置（如路由分组、子域名预设白名单）设置上传上下文，例如 $this->uploadContext = 'admin';
构造路径时用 public_path("uploads/{$this->uploadContext}/" . $filename)，而不是直接解析 HTTP_HOST
如果用 think\filesystem\Driver，可在 disk 配置里动态传参：Filesystem::disk('local')->put("{$context}/{$filename}", $content)
别忘了同步更新前端表单的隐藏字段或 API 路由前缀，确保前后端上下文一致，否则上传后 URL 生成会出错

storage_path() 和 public_path() 混用导致线上 404

有人图省事把上传文件存到 storage_path('app/uploads')，然后在模板里直接写 <img src="/storage/app/uploads/xxx.jpg">——这在本地开发可能好使（因为 php think serve 自动映射），但上线后 Nginx 不会自动代理 /storage 路径，必然 404。

根本原因：ThinkPHP 的 storage_path() 是纯服务端路径，不对外开放；只有 public_path() 下的资源才天然可被 Web 服务器直接响应。