Laravel多文件上传仅获取单个文件问题求助

问题场景 #

表单已配置多文件上传支持，代码如下：

<form name="form1" method="POST" action="{{ route('admin.jobs.store') }}" enctype="multipart/form-data"> 
@csrf
    <div class="row">
        <div class="col-md-12">
            <div class="mb-3">
                <input type="file" name="images[]" multiple>
            </div>
        </div>
    </div>
    <button type="submit" class="btn btn-primary">Submit</button>
</form>

对应Laravel控制器代码：

public function store( Request $request ) {
    $images = $request->file('images');
    dd($images);
}

但提交表单后，控制器仅能获取到单个文件，而非预期的多个文件。

解决步骤 #

1. 确认前端实际选中多个文件

上传时按住Ctrl（Windows）或Cmd（Mac）键选择多个文件，避免仅选单个文件导致的误解。也可通过前端代码验证FormData中的文件数量：

document.querySelector('form').addEventListener('submit', function(e) {
    e.preventDefault();
    const formData = new FormData(this);
    console.log('选中文件数量:', formData.getAll('images[]').length);
});

2. 修正控制器文件处理逻辑

添加文件合法性验证，并正确遍历文件数组：

public function store(Request $request)
{
    // 验证上传文件规则
    $request->validate([
        'images.*' => 'required|image|mimes:jpeg,png,jpg,gif|max:2048',
    ]);

    // 检查是否存在上传文件数组
    if ($request->hasFile('images')) {
        // 遍历处理每个文件
        foreach ($request->file('images') as $image) {
            // 示例：将文件存储到指定目录
            // $storagePath = $image->store('uploads/jobs');
            dd($image); // 可查看单个文件的详细信息
        }
    }
}

3. 检查PHP配置限制

PHP默认配置可能限制上传文件的数量或大小，导致部分文件被丢弃。修改php.ini中的以下参数：

• upload_max_filesize = 2M → 调整为合适的单个文件大小（如10M）
• post_max_size = 8M → 需大于upload_max_filesize（如20M）
• max_file_uploads = 20 → 若需上传更多文件，可适当增大此值

修改后重启PHP服务生效。

4. 确认表单核心属性无误

确保表单的enctype="multipart/form-data"属性正确设置，这是文件上传的必要条件（你的代码中已包含，可再次确认无拼写错误）。

内容的提问来源于stack exchange，提问作者abu abu