Laravel文件上传教程与实现方法

哈喽！大家好，很高兴又见面了，我是golang学习网的一名作者，今天由我给大家带来一篇《Laravel文件上传教程及实现方法》，本文主要会讲到等等知识点，希望大家一起学习进步，也欢迎大家关注、点赞、收藏、转发! 下面就一起来看看吧！

Laravel文件上传需配置表单enctype，控制器用$request->file()获取文件，store()存储至指定目录，如public磁盘需创建软链接；通过validate()验证文件类型、大小，推荐使用storeAs()自定义命名并清洗文件名以确保安全。

在Laravel中处理文件上传非常简单，框架提供了强大的支持来安全高效地管理上传操作。下面是一个完整的文件上传处理流程，适用于图片、文档等常见类型文件。

配置表单支持文件上传

要上传文件，HTML表单必须设置 enctype="multipart/form-data"，否则文件无法提交。

<form action="/upload" method="POST" enctype="multipart/form-data">
    @csrf
    &lt;input type=&quot;file&quot; name=&quot;avatar&quot;&gt;
    <button type="submit">上传</button>
</form>

控制器中处理上传文件

在控制器中通过 $request->file() 获取上传的文件对象，并使用 store() 方法保存到指定目录。

use Illuminate\Http\Request;
<p>public function upload(Request $request)
{
if ($request->hasFile('avatar') && $request->file('avatar')->isValid()) {
// 将文件存储到 public/uploads 目录下
$path = $request->file('avatar')->store('uploads', 'public');</p><pre class="brush:php;toolbar:false;">    // $path 是存储后的路径，如：uploads/abc123.jpg
    return response()->json(['path' => '/storage/'.$path]);
}

return response()->json(['error' => '文件上传失败'], 400);

说明：
- store('uploads', 'public') 表示将文件存入 storage/app/public/uploads 目录。
- 使用 public 磁盘需要运行 php artisan storage:link 创建软链接，使文件可通过 Web 访问。
- 存储后返回的路径前加上 /storage/ 即可浏览器访问。

验证文件类型和大小

为保证安全，应对接收到的文件进行校验。

$request->validate([
    'avatar' => 'required|file|image|max:2048|mimes:jpeg,png,jpg,gif'
]);

常用规则说明：

• image：确保是图片文件
• mimes:jpeg,png,jpg：限制允许的MIME类型
• max:2048：最大2MB（单位KB）
• file：确认是上传的文件而非文本

自定义文件名和存储方式

如果不想用系统生成的随机名称，可以手动指定。

$file = $request->file('avatar');
$filename = time() . '_' . $file->getClientOriginalName();
$path = $file->storeAs('uploads', $filename, 'public');

注意：使用原始文件名存在安全风险，建议清洗或避免直接使用用户上传的文件名。

基本上就这些。只要表单正确、验证到位、路径配置清晰，Laravel文件上传不复杂但容易忽略细节，比如软链接和磁盘配置。处理好这些，上传功能就能稳定运行。

今天带大家了解了的相关知识，希望对你有所帮助；关于文章的技术知识我们会一点点深入介绍，欢迎大家关注golang学习网公众号，一起学习编程~