本教程详细介绍了如何在 laravel 中实现多文件上传功能。我们将深入探讨 blade 模板中文件输入字段的正确命名方式（`name="field[]"`），以及控制器中如何高效地处理这些上传的文件，包括验证、迭代存储和路径管理。通过清晰的代码示例，帮助开发者构建健壮的多文件上传系统。
引言
在现代 Web 应用中，多文件上传是一个常见且重要的功能需求，例如上传多个图片、文档或视频。Laravel 框架提供了强大的文件存储抽象层，使得文件操作变得相对简单。然而，要正确实现多文件上传，需要确保前端的 HTML 表单与后端的控制器逻辑能够无缝协作。本教程将引导您完成 Blade 模板和控制器中的关键配置与代码实现，以构建一个功能完善的多文件上传系统。
理解 HTML 文件输入与多文件上传
在 HTML 表单中， 标签的 name 属性决定了服务器端如何接收文件。
- 单文件上传： 当您期望用户上传单个文件时，name 属性通常设置为一个简单的字符串，例如 name="avatar"。此时，request()->file('avatar') 将返回一个 UploadedFile 实例。
- 多文件上传： 当您允许用户上传多个文件时，name 属性必须以 [] 结尾，例如 name="lessons[]"。这告诉浏览器将选择的所有文件作为一个数组发送到服务器。同时，为了让用户能够选择多个文件，input 标签通常会添加 multiple 属性。
问题分析：
原始 Blade 模板中的文件输入字段定义为 。这种命名方式会导致 request()->lesson 接收到一个嵌套数组，而不是一个标准的 UploadedFile 实例或 UploadedFile 实例数组。因此，request()->hasFile('lesson') 无法正确识别它是一个文件上传字段，因为它期望的是一个非数组的 UploadedFile 实例。
Blade 模板的正确实现
为了实现多文件上传，我们需要对 Blade 模板进行以下关键修改：
- 将文件输入字段的 name 属性改为 lesson[]。
- 添加 multiple 属性，允许用户选择多个文件。
- 确保表单包含 @csrf 指令以防止 CSRF 攻击。
以下是修改后的 Blade 模板示例：
【极品模板】出品的一款功能强大、安全性高、调用简单、扩展灵活的响应式多语言企业网站管理系统。 产品主要功能如下： 01、支持多语言扩展（独立内容表，可一键复制中文版数据） 02、支持一键修改后台路径； 03、杜绝常见弱口令，内置多种参数过滤、有效防范常见XSS； 04、支持文件分片上传功能，实现大文件轻松上传； 05、支持一键获取微信公众号文章（保存文章的图片到本地服务器）； 06、支持一键
<form method="POST" action="{{ route('storeLesson') }}" enctype="multipart/form-data">
@csrf {{-- 务必添加 CSRF token --}}
<div class="mb-3">
{{-- 假设 lessonFolders 迭代是为了关联文件到文件夹。
如果每个文件夹可以上传多个文件，且每个 input 对应一个文件夹，
则需要确保 lesson_folder_id 也能与 lesson[] 数组正确对应。
这里我们假设 lesson_folder_id 也是一个数组，与 lesson[] 数量匹配。 --}}
@foreach($c->lessonFolders as $index => $f)
<p>{{ $f->name }}</p>
{{-- 确保 lesson_folder_id 也是一个数组，并与 lesson[] 索引匹配 --}}
<input hidden name="lesson_folder_id[{{ $index }}]" type="text" value="{{ $f->id }}">
<label class="form-label" for="customFile-{{ $f->id }}">上传文件到 {{ $f->name }}</label>
{{-- 关键修改：name="lesson[]" 且添加 multiple 属性 --}}
<input name="lesson[{{ $index }}][]" type="file" class="form-control" id="customFile-{{ $f->id }}" multiple>
{{-- 显示已上传文件（如果需要） --}}
@foreach($f->lessons as $l)
@if($l->lesson)
<span>已上传: {{ basename($l->lesson) }}</span><br>
@endif
@endforeach
@endforeach
</div>
<button class="btn btn-danger" type="submit">上传</button>
</form>注意： 上述 Blade 模板中，name="lesson[{{ $index }}][]" 表示每个文件夹 f 下可以上传多个文件，并且这些文件会作为 request()->lesson[$index] 的子数组。如果您的需求是所有上传的文件都属于同一个 lesson 数组，并且可能关联到多个 lesson_folder_id，那么 input name="lesson[]" 应该在循环外，或者 lesson_folder_id 的关联逻辑需要在控制器中根据实际业务调整。本教程将以更通用的 name="lesson[]"（即所有文件都归属于一个 lesson 数组）为例进行控制器讲解，并假设 lesson_folder_id 数组与 lesson 数组的索引是一一对应的。
Laravel 控制器处理多文件上传
处理多文件上传的控制器需要进行以下步骤：
- 验证输入： 使用 Laravel 的验证器对上传的文件进行类型、大小、数量等方面的验证。
- 访问文件： 通过 request()->file('fieldName') 获取上传的文件数组。
- 迭代存储： 遍历文件数组，对每个文件进行存储操作。
- 数据库关联： 将每个文件的存储路径记录到数据库中，通常需要一个单独的关联表或 JSON 字段来存储多个文件路径。
以下是优化后的控制器代码：
<?php
namespace App\Http\Controllers;
use App\Models\Lesson; // 确保引入 Lesson 模型
use Illuminate\Http\Request; // 确保引入 Request
class LessonController extends Controller
{
/**
* 处理多文件上传并存储课程文件。
*
* @param \Illuminate\Http\Request $request
* @return \Illuminate\Http\RedirectResponse
*/
public function storeLesson(Request $request)
{
// 1. 验证输入
// 验证 lesson_folder_id 必须是一个数组，并且每个ID都存在于 lesson_folders 表中
// 验证 lesson 必须是一个数组，并且数组中的每个元素都必须是文件，符合指定格式和大小
$validatedData = $request->validate([
'lesson_folder_id' => 'required|array', // 确保 lesson_folder_id 是数组
'lesson_folder_id.*' => 'required|exists:lesson_folders,id', // 验证每个 ID 是否存在
'lesson' => 'required|array', // 验证 lesson 字段必须是一个数组
'lesson.*' => 'required|file|mimes:pdf,doc,docx,mp4,mov|max:102400', // 针对数组中的每个文件进行验证 (示例：允许文档和视频，最大100MB)
], [
'lesson.required' => '请选择至少一个文件进行上传。',
'lesson.*.required' => '文件不能为空。',
'lesson.*.file' => '上传的必须是文件。',
'lesson.*.mimes' => '文件格式不正确，支持 PDF, DOC, DOCX, MP4, MOV。',
'lesson.*.max' => '文件大小不能超过 100MB。',
'lesson_folder_id.required' => '课程文件夹ID不能为空。',
'lesson_folder_id.*.exists' => '指定的课程文件夹不存在。',
]);
$uploadedPaths = [];
// 2. 处理文件上传
// request()->hasFile('lesson') 对于 lesson 是数组时仍可工作，因为它会检查数组中是否有有效文件
if ($request->hasFile('lesson')) {
// 遍历上传的文件数组
foreach ($request->file('lesson') as $index => $file) {
// 确保文件有效且没有上传错误
if ($file->isValid()) {
// 使用 'my_files' disk 存储文件，并返回存储路径
$path = $file->store('lessons', ['disk' => 'my_files']);
$uploadedPaths[] = $path;
// 假设 Lesson 模型代表一个文件记录，并关联到相应的 lesson_folder_id。
// 注意：这里假设 lesson_folder_id 数组与 lesson 数组的索引是对应的。
// 如果前端逻辑不同，此处的关联逻辑需要相应调整。
$lessonFolderId = $validatedData['lesson_folder_id'][$index] ?? null;
if ($lessonFolderId) {
Lesson::create([
'lesson' => $path, // 存储文件路径
'lesson_folder_id' => $lessonFolderId,
// 您可以在这里添加其他 Lesson 模型的字段
// 'name' => $file->getClientOriginalName(),
// 'size' => $file->getSize(),
// 'mime_type' => $file->getMimeType(),
]);
}
}
}
}
// 3. 返回响应
if (!empty($uploadedPaths)) {
return redirect('/courses')->with('success', '文件已成功上传。');
} else {
// 如果没有文件被成功上传，返回错误信息
return redirect()->back()->with('error', '文件上传失败，请重试或检查文件。');
}
}
}控制器代码说明：
- storeLesson(Request $request)： 注入 Request 实例是 Laravel 中获取请求数据的标准做法。
-
验证：
- 'lesson' => 'required|array' 确保 lesson 字段作为一个数组存在。
- 'lesson.*' => 'required|file|mimes:...' 针对数组中的每个文件应用验证规则。* 是一个通配符，表示数组中的每个元素。
- 'lesson_folder_id' => 'required|array' 和 'lesson_folder_id.*' => 'required|exists:lesson_folders,id' 确保 lesson_folder_id 也是一个数组，并且每个 ID 都有效。
- 文件遍历： foreach ($request->file('lesson') as $index => $file) 循环遍历 lesson 字段上传的所有文件。每个 $file 都是一个 UploadedFile 实例。
- $file->isValid()： 这是一个重要的检查，确保上传的文件没有发生错误。
- $file->store('lessons', ['disk' => 'my_files'])： 将文件存储到 config/filesystem.php 中定义的 my_files 磁盘下的 lessons 目录中。Laravel 会自动生成一个唯一的文件名。
- 数据库存储： 在循环内部，为每个成功上传的文件创建一个新的 Lesson 模型记录，并关联其 lesson_folder_id。这假设您的 Lesson 模型代表一个文件记录。如果您的 Lesson 模型代表一个课程，且一个课程可以有多个文件，那么您可能需要一个单独的 Media 或 File 模型，并通过多态关联或中间表将文件与课程关联起来。
- 错误处理： 根据 uploadedPaths 是否为空，返回
