Laravel 9多文件上传计数与验证限制问题修正

修复后的完整代码 #

public function apiUserGalleryImageStore(Request $request) {
    $rules = [
        'email' => 'required|email|string',
        'image' => 'required|array|max:4',
        'image.*' => 'required|mimes:jpg,jpeg,png|max:1024',
    ];
    $validator = Validator::make($request->all(), $rules);

    if ($validator->fails()) {
        return response()->json([
            'status' => 422,
            'message' => $validator->errors(),
            'data' => null
        ], 422);
    }

    $images = $request->file('image');
    // 双重校验文件数量
    if(count($images) > 4) {
        return response()->json([
            'status' => 422,
            'message' => '最多只能上传4个文件',
            'data' => null
        ], 422);
    }

    // 通过email获取用户ID，替代硬编码的固定值
    $user = User::where('email', $request->email)->first();
    if(!$user) {
        return response()->json([
            'status' => 404,
            'message' => '用户不存在',
            'data' => null
        ], 404);
    }

    $uploadSuccess = true;
    foreach ($images as $img) {
        $imageName = hexdec(uniqid()) . '.' . $img->getClientOriginalExtension();
        $directory = 'support-files/images/user/gallery/';
        
        // 确保存储目录存在
        if(!File::exists($directory)) {
            File::makeDirectory($directory, 0755, true);
        }
        
        $img->move($directory, $imageName);
        $imageUrl = $directory . $imageName;
        
        $insertResult = UserGallery::insert([
            'user_id' => $user->id,
            'photo_name' => $imageUrl,
            'created_at' => Carbon::now(),
        ]);
        
        if(!$insertResult) {
            $uploadSuccess = false;
            break;
        }
    }

    if($uploadSuccess) {
        return response()->json([
            'status' => 200,
            'message' => '所有图片上传成功',
            'data' => null
        ], 200);
    } else {
        return response()->json([
            'status' => 422,
            'message' => '图片上传失败，请重试',
            'data' => null
        ], 422);
    }
}

关键修改说明 #

• 修正多文件验证规则：将image字段规则改为required|array|max:4，明确要求接收数组类型且最多4个文件；通过image.*验证每个文件的格式（jpg/jpeg/png）和大小（不超过1M），适配多文件上传场景。
• 修复数量限制逻辑：原代码判断条件与提示信息完全不符，现在改为count($images) > 4，提示信息修正为“最多只能上传4个文件”，与需求一致。
• 移除循环内的返回语句：原代码上传单个文件后立即返回，导致仅能处理第一个文件。现在将响应逻辑移至循环结束后，确保所有文件处理完成后统一返回结果。
• 替换硬编码用户ID：原代码固定user_id=1，改为通过请求中的email查询真实用户ID，同时增加用户不存在的异常处理，符合业务逻辑。
• 优化上传细节：添加存储目录存在性检查，避免因目录未创建导致上传失败；改用getClientOriginalExtension()获取文件扩展名，避免原文件名含多个点导致的格式错误。
• 修正响应字段语义：将原响应中的error键名改为message，成功提示改为“所有图片上传成功”，语义更准确。

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