Laravel 中文件请求与普通请求本质同为 HTTP 请求，但框架仅对 multipart/form-data 自动解析文件，需显式调用 $request->file() 获取 UploadedFile 实例，且 all() 不包含文件字段，上传仍受 CSRF 保护，临时文件路径仅限当前请求有效。
文件请求和普通请求在 Laravel 中本质都是 HTTP 请求，但处理逻辑、底层校验、安全边界和响应方式有明确分界。关键区别不在“能不能传文件”，而在于「框架是否默认启用文件解析」以及「你是否显式调用文件处理方法」。
request()->file() 只对 multipart/form-data 有效
当你用 POST 提交表单但 enctype 是 application/x-www-form-urlencoded（默认值）时，$request->file('avatar') 永远返回 null，哪怕前端确实附了文件——Laravel 根本不解析文件字段。
- 必须把表单设为
enctype="multipart/form-data" -
$request->file()返回的是Illuminate\Http\UploadedFile实例，不是原始数组或字符串 - 若直接用
$request->input('avatar')读取同名字段，会得到空字符串或报错，不是文件对象
文件上传失败时不会抛异常，但 $request->file() 会返回 null 或带错误码的 UploadedFile
上传超限、类型不匹配、临时目录不可写等常见问题，都不会中断执行流程，而是让 $request->file('xxx') 返回一个“有错误”的对象，需手动检查：
-
$file->isValid()必须为true才能继续移动或读取 -
$file->getError()返回 PHP 的UPLOAD_ERR_*常量（如UPLOAD_ERR_INI_SIZE） - 直接调用
$file->move()而不先验证isValid()，会触发UnexpectedValueException
普通请求参数（GET/POST）和文件参数不能混用 all() 一次性获取
$request->all() 默认**不包含文件字段**。它只合并 $_GET 和 $_POST 数据，$_FILES 是独立的超全局变量。
- 想同时拿到文本字段和文件，得分开处理：
$request->all()+$request->file('photo') -
$request->only(['name', 'email'])对文件字段无效；$request->except(['password'])也过滤不掉文件 - 若强行把
UploadedFile实例塞进数组再json_encode，会报Object of class ... could not be converted to string
文件请求默认禁用 CSRF 验证？不，它仍然受保护
很多人误以为「上传接口不用加 @csrf」，其实只要路由走的是 web 中间件组，Laravel 就强制校验 CSRF token——哪怕你只传一个文件。
- 没带
_token字段 → 419 页面过期错误（TokenMismatchException） - 用
axios或fetch上传时，记得手动 append token：formData.append('_token', token) - API 路由（
api中间件组）默认跳过 CSRF，但也就意味着你得自己做身份和合法性校验
最易被忽略的一点：文件临时路径生命周期极短，UploadedFile 对象一旦离开当前请求作用域，其 getRealPath() 就失效——别试图在队列任务里直接用它，必须先 store() 或 move() 到持久位置。
