Laravel怎么上传文件_Laravel文件上传处理方法【教程】-Laravel-PHP中文网

laravel上传文件返回null主因是表单缺少enctype="multipart/form-data"或input name与request()->file()参数不一致；store()自动命名存storage/app，storeas()手动指定路径名；mimes校验基于文件头，需配合extensions规则防伪扩展名；大文件需同步调整php upload_max_filesize和post_max_size；storage文件需执行storage:link并用storage::url()生成可访问url。

laravel怎么上传文件_laravel文件上传处理方法【教程】

上传文件时 `request()->file()` 返回 null 怎么办

Laravel 里拿不到上传的文件，大概率是表单没写对。不是后端代码的问题，而是前端漏了关键属性。

表单必须带 enctype="multipart/form-data"，否则浏览器根本不会把文件数据发过来
<input type="file"> 的 name 属性值，要和 request()->file('xxx') 里的字符串完全一致（包括大小写和下划线）
如果用了数组式命名比如 name="photos[]"，那得用 request()->file('photos') 拿到的是数组，不能还写 file('photos.0')

常见错误现象：Call to a member function store() on null，就是 request()->file() 没取到对象。

`store()` 和 `storeAs()` 该选哪个

两者都存文件，但控制粒度不同，选错容易导致路径混乱或覆盖。

store('uploads')：自动用随机哈希名存进 storage/app/uploads/，适合不想管文件名、防重名的场景
storeAs('avatars', $filename)：手动指定完整相对路径+文件名，比如 storeAs('avatars', 'user_123.jpg')，适合要保留原始名或按业务逻辑组织目录的情况
注意：两个方法默认都存在 storage/app/ 下，如果想存到 public 目录供直接访问，得配 public 磁盘并用 storePublicly() 或先 store() 再 copyToPublic()

性能影响不大，但 storeAs() 多一次字符串拼接；兼容性上无差异。

验证文件类型和大小为什么总失效

Laravel 的 mimes 或 mimetypes 规则不是靠文件扩展名判断的，而是读文件头（magic number），所以配置不对就白写。

Laravel 13.2.0

PHP中文网提供Laravel 13.2.0版本下载，Laravel框架是基于 PHP 8.3+ 的高性能框架，官方推荐通过 Composer 安装。它内置 AI SDK、JSON:API Resources 及原生向量搜索，支持属性驱动开发与队列路由，大幅提升开发效率。相比旧版，13.2.0 优化了缓存 TTL 管理与实时通信，无需 Redis 即可横向扩展。作为现代 Web 开发首选，它兼顾安全与极速体验，助您快速构建企业级应用。

下载

'avatar' => 'required|mimes:jpg,jpeg,png' 这种写法只校验 MIME 类型，不校验扩展名。如果用户把 .pdf 改成 .jpg 上传，仍可能通过
更稳妥的是加扩展名检查：'avatar' => 'required|mimes:jpg,jpeg,png|extensions:jpg,jpeg,png'（extensions 是 Laravel 9+ 才内置的规则）
文件大小限制写 'max:2048' 是指 KB，不是 MB；且 PHP 配置 upload_max_filesize 和 post_max_size 必须 ≥ 这个值，否则请求在到达 Laravel 前就被 Nginx/Apache 拦截了，连 413 错误都不会进框架