ThinkPHP 6 中获取上传文件必须用 $request->file('field_name')，返回 think\File 实例，不可用 input() 或 param()；多文件需前端命名 name="photos[]" 且服务端调用 $request->file('photos') 得数组；字段不存在时返回 null，须判空；常见失败原因是表单缺失 enctype="multipart/form-data"、PHP 配置 upload_max_filesize 不足或 file_uploads=Off。
ThinkPHP 6 的 request 对象怎么取上传文件
直接用 $request->file('field_name')，不是 input()，也不是 param() —— 这是初学者最常踩的坑。ThinkPHP 6 把文件上传单独抽离为 file() 方法，和普通参数完全隔离。
它返回的是 think\File 实例（不是 $_FILES 原生数组），后续操作（移动、验证、获取信息）都基于这个对象。
- 如果表单字段是
<input type="file" name="avatar">，就用$request->file('avatar') - 支持多文件：字段名带
[]（如photos[]），$request->file('photos')返回File对象数组 - 若字段不存在或没传文件，
file()返回null，别直接调方法，先判空
ThinkPHP 5.1 怎么用 request 获取上传文件
语法一样，也是 $request->file('field_name')，但底层类不同：TP5.1 返回的是 think\Files（注意末尾是复数），而 TP6 是 think\File（单数）。两者 API 高度兼容，但部分方法签名有差异，比如 validate() 在 TP5.1 中不支持 MIME 类型数组校验。
- TP5.1 中
file()不支持直接传['size' => 2097152]这样的完整规则数组，得拆成rule+message两组参数 - TP5.1 默认允许上传空文件（即 size === 0），TP6 默认拒绝；如需兼容旧逻辑，要显式加
->checkRule(['size' => 0]) - 路径处理上，TP5.1 的
move()第二个参数是子目录，TP6 则要求是完整相对路径（如'uploads/avatar'而非'avatar'）
$request->file() 返回 null 或报错的常见原因
不是代码写错了，大概率是请求或配置问题。重点查这三块：
立即学习“PHP免费学习笔记（深入）”；
- 表单
<form>缺少enctype="multipart/form-data"—— 这是最高频原因，没它，浏览器根本不会发送文件数据 - PHP 配置限制：检查
upload_max_filesize和post_max_size，二者都必须 ≥ 文件大小；file_uploads = On也得开着 - TP 自动过滤：如果用了
middleware拦截了Content-Type: multipart/form-data，或者自定义了Request初始化逻辑覆盖了原始$_FILES，file()就会失效
调试时可临时加一行：var_dump($_FILES);，看原生数组是否为空 —— 如果为空，问题一定出在前端或 PHP 层；如果不为空但 $request->file() 为空，就是框架层解析异常。
上传后怎么安全地移动并获取真实路径
别用 move() 直接扔到 public/ 下就完事。ThinkPHP 的 move() 默认生成唯一文件名，但目标路径必须是相对于 root_path() 的，且不能写绝对路径或以 / 开头。
- 正确写法：
$file->move('uploads/avatar', 'new_name.jpg')→ 最终路径是ROOT_PATH . 'uploads/avatar/new_name.jpg' - 移动成功后，用
$saved->getRealPath()拿服务器绝对路径，用$saved->getSaveName()拿保存后的文件名（含哈希前缀） - 对外访问 URL 要自己拼：如果
uploads/avatar/映射到/uploads/avatar/，那 URL 就是/uploads/avatar/xxx.jpg；别依赖$saved->getPathname()，它返回的是临时路径 - 注意权限：Linux 下确保
uploads目录对 web 用户可写，Windows 下则留意 NTFS 权限继承是否被中断
移动失败时，move() 抛异常而不是返回 false，记得 try-catch；错误码通常对应 PHP 的 UPLOAD_ERR_XXX 常量，比如 UPLOAD_ERR_INI_SIZE 表示超了 upload_max_filesize。
