Laravel PHP多图上传问题：仅单张图入库，如何实现全图上传

问题分析 #

1. 表单字段名不匹配：视图中文件输入框的name是files[]，但模型中尝试获取的是property_files，导致无法正确获取上传的多个文件。
2. 未循环处理多文件：当前代码仅处理单张图片，没有遍历所有上传的文件进行存储。
3. 文件命名冲突：直接使用$lastID.".jpg"会导致多张图片覆盖同名文件，需要生成唯一文件名。
4. 缺少多图存储的数据库结构：多图需要单独的关联表来存储每张图片与房产的关系，不能仅依赖主表。

解决方案步骤 #

1. 修正视图表单字段名 #

将视图中的文件输入框name改为property_files[]，与模型中调用的字段名一致：

<h3>Gallery</h3>
<div class="submit-section">
    <div id="selected-files"></div>
    <input type="file" name="property_files[]" multiple onchange="Property.onImageUploadChange(event)" id="files" >
</div>

2. 创建关联图片表 #

执行迁移创建property_images表，用于存储房产图片（对应创建PropertyImage模型，与Property模型建立一对多关联）：

Schema::create('property_images', function (Blueprint $table) {
    $table->id();
    $table->unsignedBigInteger('property_id');
    $table->string('image_path');
    $table->timestamps();

    $table->foreign('property_id')->references('id')->on('properties')->onDelete('cascade');
});

3. 修改模型代码，循环处理多文件 #

更新addProperty方法，遍历所有上传的文件，保存到服务器并写入数据库：

public function addProperty($propertyData, $request)
{
    $db = new Database;
    @session_start();
    $user = $_SESSION["user"];
    $propertyData["user_id"] = $user->user_id;
    unset($propertyData["_token"]);
    unset($propertyData["property_files"]);

    // 插入房产主数据
    $res = $db->query($db->buildQuery($propertyData, $this->tableName)) or die(false);
    $lastID = $db->lastInsertID($res);

    // 处理上传的多张图片
    if ($request->hasFile('property_files')) {
        foreach ($request->file('property_files') as $image) {
            // 验证文件有效性
            if ($image->isValid()) {
                // 生成唯一文件名，避免冲突
                $fileName = $lastID . '_' . uniqid() . '.' . $image->getClientOriginalExtension();
                // 移动文件到指定目录
                $image->move(public_path('images'), $fileName);
                // 插入图片路径到关联表
                $imageData = [
                    'property_id' => $lastID,
                    'image_path' => $fileName
                ];
                $db->query($db->buildQuery($imageData, 'property_images'));
            }
        }
    }

    return true;
}

4. 额外优化建议 #

• 在控制器中添加文件验证规则，限制上传文件的类型和大小：

$request->validate([
    'property_files.*' => 'image|mimes:jpeg,png,jpg,gif|max:2048'
]);

• 建议使用Laravel自带的Storage门面替代直接操作public_path，更符合框架规范。

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