move_uploaded_file()后文件丢失的主因是路径拼接错位，如$uploadDir未以/结尾导致'uploadsa.jpg'；应确保目录以/结尾、用realpath()验证存在可写、存相对路径而非绝对URL。
move_uploaded_file() 后路径拼接错位导致文件丢失
常见现象是 move_uploaded_file() 返回 true，但目标位置找不到文件——根本不是函数失败，而是你拼的 $targetPath 和实际写入路径不一致。
关键原因：漏掉目录分隔符或误用相对路径。比如 $uploadDir = 'uploads'（末尾没斜杠） + $filename = 'a.jpg' → 拼成 'uploadsa.jpg'，而非 'uploads/a.jpg'。
- 始终确保
$uploadDir以/结尾，或统一用dirname(__FILE__) . '/uploads/'构造绝对路径 - 用
realpath($uploadDir)验证目录真实存在且可写，别只靠file_exists() - 拼接时显式加斜杠：
$targetPath = $uploadDir . '/' . $newName，比依赖变量结尾更可靠 - Windows 下慎用
__DIR__ . '\uploads\'—— PHP 虽能识别反斜杠，但 Web 服务器（如 Nginx）和 URL 解析一律认正斜杠
存数据库的路径该用相对还是绝对？
存绝对路径（如 /var/www/html/uploads/202608/abc.jpg）看似“完整”，实则锁死部署结构：换服务器、改 DocumentRoot、上 Docker，所有读取逻辑全崩。
正确做法是只存 Web 可访问的相对路径（如 uploads/202608/abc.jpg），输出时再补前缀。这样迁移时只需改一个配置点。
立即学习“PHP免费学习笔记（深入）”；
- HTML 中渲染：
<img src="/<?php echo htmlspecialchars($row['image_path']); ?>">（开头斜杠确保从根开始） - 如果项目不在 Web 根目录（如部署在
https://example.com/myapp/），用$_SERVER['SCRIPT_NAME']或配置项动态算出 base path - 千万别存
http://开头的绝对 URL——CDN 切换、HTTPS 强制跳转、本地开发环境都会出问题
ThinkPHP 的 Storage::disk()->put() 路径怎么写才不翻车
直接写 Storage::disk('upload')->put('public/uploads/202608/abc.jpg', $file) 是典型错误：local 驱动会真往 public/uploads/ 下写，但 OSS 驱动会把 public/uploads/ 当 key 前缀，最终上传到 oss-bucket/public/uploads/202608/abc.jpg，URL 完全不对。
真正要传给 put() 的，是纯逻辑路径（不含 public/、uploads/ 等物理层前缀）。
- 生成 key 应为
'202608/abc.jpg'，不是'uploads/202608/abc.jpg' - disk 配置里
'root' => public_path('uploads')（local）或'root' => ''（OSS）已定义落盘规则，业务代码不该越界 - 获取可访问 URL 必须用
Storage::url('202608/abc.jpg')，它会自动补前缀；硬拼/uploads/202608/abc.jpg在 OSS 场景下返回 404 - 路径中避免
date('Y/m/d')——/在 Windows 文件系统非法，date('Y-m/d')也不行，得用date('Y-m') . '/' . date('d')
GD 生成图后保存失败？检查 imagepng() 的第二个参数
imagepng($image, $path) 的 $path 如果是相对路径（如 'tmp/chart.png'），它会相对于当前执行脚本位置写入，而不是 Web 根目录——结果图存在了，但前端压根访问不到。
更隐蔽的问题是：GD 函数不报错，但返回 false 时你没捕获，以为保存成功。
- 必须检查返回值：
if (!imagepng($image, $fullPath)) { error_log("GD save failed: $fullPath"); } -
$fullPath推荐用绝对路径：__DIR__ . '/../public/images/generated/' . $filename - 确保目标目录存在且权限正确：
is_writable(dirname($fullPath))比file_exists()更准 - 生成图若需前端直接访问，路径必须落在 Web 服务器可服务范围内（如 Nginx 的
root目录下），不能藏在app/或config/里
