Laravel中如何实现文件上传和管理

在 Lara vel 中做文件上传和管理，其实就相当于搭一条流水线：表单收文件、路由引路、控制器处理、存储落地、最后再展示出来。说起来不复杂，但每一步都有几个容易踩的坑。下面我们拆开来聊聊。

首先，你得有一个能接收文件的表单。老生常谈的一点：千万别忘了在 form 标签里加上 enctype="multipart/form-data"，否则 Lara vel 收不到文件数据。另外，@csrf 也不能少，这是 Lara vel 的安全机制，防止跨站请求伪造。

@csrf

上传文件

接下来，路由是入口。在 routes/web.php 里定义好 POST 路由，指向控制器里的 upload 方法：

Route::post('/file/upload', 'FileController@upload')->name('file.upload');

然后是核心环节——控制器。用 Artisan 命令 php artisan make:controller FileController 生成文件，然后在里面写 upload 方法。注意这里要做两件事：第一是验证，确保用户确实上传了文件（并且是合法的文件）；第二是用 Lara vel 的 store 方法保存文件，默认会放到 storage/app/uploads 目录下。你也可以改成其他路径，比如按日期分文件夹：

use Illuminate\Http\Request;
use Illuminate\Support\Facades\Storage;

public function upload(Request $request)
{
    $request->validate([
        'file' => 'required|file',
    ]);

    $filePath = $request->file('file')->store('uploads');

    return back()->with('success', '文件上传成功！');
}

文件存好了，还得让用户能看到。再建一个视图 resources/views/file_list.blade.php，把文件列表遍历出来：

@foreach ($files as $file)
{{ $file }}
@endforeach

然后在同一个控制器里加一个 listFiles 方法，通过 Storage::disk('local')->files('uploads') 拿到所有文件名，传给视图：

public function listFiles()
{
    $files = Storage::disk('local')->files('uploads');
    return view('file_list', compact('files'));
}

别忘了路由也得补上：

Route::get('/files', 'FileController@listFiles')->name('file.list');

最后，如果你希望上传完成后直接跳转到文件列表页，可以把表单的 action 改成列表路由的 URL——当然，这就意味着 upload 方法里要调整一下重定向的目标。你自己根据实际需求来就行。

@csrf

上传文件

这套流程跑通之后，你还可以再扩展：比如加文件删除、文件预览、权限控制等等。不过最基本的骨架就是这样——表单收、路由接、控制器验、存储存、视图展。循序渐进，Lara vel 的文件处理真的不难。