ThinkPHP上传文件应通过$request->file('name')获取think\File实例，而非手动new；该实例需调用move()移动文件，上传前必须用validate规则校验，目标目录须存在且有写权限，成功后用getSaveName()拼接URL。
ThinkPHP 上传文件时 File 类怎么用
ThinkPHP 的 File 类不是你手动 new 的上传类，它只是对上传文件信息的封装，真正干活的是 Request 对象的 file() 或 file('name') 方法。别在文档里翻 File 类构造函数——它不负责接收、移动、验证，只管“描述这个文件长啥样”。
常见错误现象：new File(...) 报错、上传后拿不到 getRealPath()、isValid() 始终返回 false。
- 上传入口永远从
$request->file('avatar')开始，返回一个think\File实例（注意命名空间） -
think\File实例不能直接 move，必须先调用move()方法（它内部才真正执行文件移动） - 上传失败时，
$file可能是null，而不是一个无效的File对象，记得判空 -
move()成功返回新think\File实例，失败抛异常，不返回布尔值
上传前用 validate 规则拦住非法文件
验证不是可选动作，是必须前置步骤；否则 move() 可能因超限、类型不符直接崩溃，且不会触发自定义错误提示。
使用场景：限制图片上传、禁止 PHP 文件、防止超大 ZIP 解压攻击。
立即学习“PHP免费学习笔记（深入）”；
- 规则写在控制器里，用数组传给
move($savePath, $savename, true, $validate)的第四个参数 - 常用验证项：
['size' => 2097152, 'ext' => 'jpg,png,gif', 'type' => 'image/jpeg,image/png'] -
type是 MIME 类型，不是后缀，$_FILES['x']['type']可被伪造，仅作辅助；ext更可靠，但也要配合服务端检测 - 注意大小单位是字节，
2MB = 2097152，别写成2 * 1024 * 1024—— TP 不支持表达式，只认整数
move() 失败却不报错？检查这些硬性条件
TP 的 move() 静默失败，往往不是代码写错，而是环境或路径卡住了。
常见错误现象：返回 null、没报错但目标目录空空如也、日志里出现 failed to open stream: No such file or directory。
- 目标目录必须真实存在且 PHP 进程有写权限（
chmod -R 755不够，得是775或属组正确） -
$savePath是相对ROOT_PATH . 'public/uploads/'的路径，不是绝对路径，别加/开头 -
$savename如果为null，TP 会自动生成唯一名；若指定，务必不含扩展名（扩展名由原始文件决定） - 如果用了子目录（如
'user/avatar/'），确保该子目录已创建，move()不自动建多级目录
上传成功后怎么拿到完整 URL 路径
别拼接 $_SERVER['HTTP_HOST']，也别硬写域名——URL 构建要和部署方式解耦。
使用场景：返回给前端展示、存入数据库、生成缩略图地址。
- 上传到
public/uploads/下，对应 URL 就是/uploads/xxx.jpg（注意开头斜杠） - 用
Url::build()没用，它生成的是路由地址；直接拼字符串最稳：config('app.url') . '/uploads/' . $savedFile->getSaveName() -
$savedFile->getSaveName()返回带子路径的文件名（如user/2024/abc.png），别再手动加目录 - 如果用了对象存储或 CDN，这里就是替换点；但本地开发时，别提前抽象，容易绕晕
上传逻辑看着简单，但每一步都依赖上一步的严格校验。最容易被忽略的是：验证规则没生效就调了 move()，或者以为 move() 返回布尔值去 if 判断。真出问题时，先看 var_dump($file) 和 $file->getError()，比翻文档快得多。
