如何在Yii2中使用kartik-v/yii2-widget-fileinput实现多文件上传？

我帮你分析下问题根源，以及对应的解决方案：

问题核心原因 #

你在视图的FileInput Widget配置里重复手动设置了name和attribute属性，这会覆盖$form->field()自动生成的正确字段名。原本$form->field($model, 'imageFiles[]')会生成name="Hotel[imageFiles][]"的表单字段，天然支持多文件数组传递；但手动设置name后，每个上传的文件都会使用同一个name="imageFiles[]"，导致后端只能接收到最后一个文件。

分步解决方案 #

1. 修正视图中的Widget配置 #

去掉冗余的name和attribute配置，让$form->field()自动处理字段名：

<?= $form->field($model, 'imageFiles[]')->widget(FileInput::classname(), [
    'options' => ['multiple' => true],
    'pluginOptions' => [
        'previewFileType' => 'any',
        'showPreview' => true,
        'showCaption' => true,
        'showRemove' => true,
        'showUpload' => false,
        'uploadClass' => 'hide',
        'overwriteInitial'=>false,
        'initialPreviewAsData'=>true,
        'uploadUrl' => Url::to(['/site/image-manager-upload']),
        'fileActionSettings' =>['showUpload' => false],
        'maxFileCount' => 4, // 建议和模型rules里的maxFiles保持一致
    ],
]); ?>

2. 优化控制器的Create方法 #

注意不要重复调用load()，同时添加文件上传后的实际处理逻辑（示例中假设将文件保存到uploads/hotel目录）：

public function actionCreate()
{
    $model = new Hotel();

    if ($model->load(Yii::$app->request->post())) {
        // 获取所有上传的文件实例
        $model->imageFiles = UploadedFile::getInstances($model, 'imageFiles');
        
        // 处理文件上传的示例逻辑
        if ($model->imageFiles) {
            $uploadPath = Yii::getAlias('@webroot/uploads/hotel/');
            // 确保上传目录存在
            if (!file_exists($uploadPath)) {
                mkdir($uploadPath, 0777, true);
            }
            
            $savedPaths = [];
            foreach ($model->imageFiles as $file) {
                $uniqueName = uniqid() . '.' . $file->extension;
                if ($file->saveAs($uploadPath . $uniqueName)) {
                    $savedPaths[] = '/uploads/hotel/' . $uniqueName;
                }
            }
            // 如果需要将文件路径存入数据库，可转成字符串存储（比如用逗号分隔）
            // $model->image_paths = implode(',', $savedPaths);
        }

        // 这里根据需求选择是否跳过验证，若文件已处理可传false
        if ($model->save(false)) {
            return $this->redirect(['view', 'id' => $model->id]);
        }
    }

    return $this->render('create', [
        'model' => $model,
    ]);
}

3. 统一模型规则的限制 #

建议将模型中imageFiles的maxFiles和Widget的maxFileCount保持一致，避免逻辑冲突：

public function rules()
{
    return [
        // 其他规则...
        [['imageFiles'], 'file', 'skipOnEmpty' => false, 'extensions' => 'png, jpg', 'maxFiles' => 4],
    ];
}

验证效果 #

修改完成后重新测试上传多个文件，此时UploadedFile::getInstances($model, 'imageFiles')应该能获取到所有上传的文件实例，你可以通过var_dump($model->imageFiles)来确认。

内容的提问来源于stack exchange，提问作者Иван Иванов