ThinkPHP文件上传核心是通过Request获取think\File对象后调用move()保存，需确保表单enctype="multipart/form-data"，上传前须validate校验，move时指定路径并处理返回结果。
ThinkPHP 文件上传主要通过内置的 think\File 类和 think\Http\Request 对象完成，支持单文件、多文件、限制类型/大小、自定义保存路径等常用功能。核心是获取上传文件对象后调用 move() 方法保存。
获取上传文件对象
在控制器中，使用 $this->request->file() 获取上传的文件（表单字段名需匹配）：
- 单文件：如表单字段为
image，则$file = $this->request->file('image'); - 多文件：若字段名为
images[]，则$files = $this->request->file('images');返回数组 - 注意：确保 HTML 表单设置了
enctype="multipart/form-data"
验证与移动文件
上传前建议校验文件合法性，再调用 move() 保存：
-
$file->isValid()判断是否为有效上传文件 -
$file->checkExt(['jpg', 'png', 'gif'])限制扩展名 -
$file->checkSize(2 * 1024 * 1024)限制大小（单位字节，如 2MB） -
$file->move(ROOT_PATH . 'public' . DS . 'uploads')移动到指定目录（自动创建子目录并重命名） - 成功返回
think\File对象，可调用getSaveName()获取保存后的完整路径名
自定义保存行为
可通过参数控制保存逻辑：
立即学习“PHP免费学习笔记（深入）”；
move($path, $savename = '', $replace = true, $autocheck = true)-
$savename可传入自定义文件名（含扩展名），如'avatar_' . time() . '.png' -
$replace = true允许覆盖同名文件；设为false则避免覆盖 -
$autocheck = false跳过自动重命名（需确保$savename唯一且安全）
常见问题处理
上传失败时，优先检查以下几点：
- PHP 配置：
file_uploads=On、upload_max_filesize和post_max_size是否足够大 - 目录权限：确保
public/uploads目录可写（Linux 下常需chmod 755或777） - 错误信息：
$file->getError()可获取具体失败原因（如 '上传文件为空'、'不允许的文件类型'） - ThinkPHP 版本差异：5.1+ 使用
Request::file()，6.x 推荐用Request::file()或依赖注入方式获取
