Yii2：提交注册表单后File Input报Array to string conversion错误

嘿，这个错误我之前踩过坑！从你描述的情况来看，确实大概率和fileInput()的调用有关——本质问题是某个数组类型的变量被当成字符串来处理了，下面给你一步步排查和解决的思路：

1. 先检查模型的属性配置 #

如果你的表单里用到了文件上传（不管单个还是多个），模型里对应的属性得正确声明：

• 要是上传多个文件，属性必须定义成数组：

class User extends ActiveRecord // 或者Model
{
    public $avatar; // 单个文件的话可以是普通属性
    public $attachments = []; // 多个文件一定要设成数组

    public function rules()
    {
        return [
            // 单个文件验证规则
            ['avatar', 'file', 'extensions' => 'jpg,png', 'maxSize' => 1024*1024],
            // 多个文件验证规则，要加maxFiles参数
            ['attachments', 'file', 'extensions' => 'pdf,doc', 'maxFiles' => 3],
        ];
    }
}

2. 确认视图里的fileInput代码 #

如果是多选文件，必须在fileInput()里加上multiple参数，不然表单提交时可能会把文件信息包装成数组，但模型属性没准备好接收：

<?php $form = ActiveForm::begin(['options' => ['enctype' => 'multipart/form-data']]); ?>
<!-- 单个文件 -->
<?= $form->field($model, 'avatar')->fileInput() ?>
<!-- 多个文件，一定要加multiple -->
<?= $form->field($model, 'attachments')->fileInput(['multiple' => true]) ?>
<!-- 你的其他字段 -->
<?= $form->field($model, 'username')->textInput(['autofocus' => true]) ?>
<?= $form->field($model, 'password')->passwordInput() ?>
<?= $form->field($model, 'email') ?>
<?php ActiveForm::end(); ?>

⚠️ 别忘了给表单加enctype="multipart/form-data"，不然文件根本传不上去！

3. 控制器里的文件处理不能错 #

接收上传文件时，要使用Yii提供的UploadedFile类，千万别直接把$model->你的属性当成字符串用：

public function actionRegister()
{
    $model = new User();

    if ($model->load(Yii::$app->request->post())) {
        // 单个文件用getInstance
        $model->avatar = UploadedFile::getInstance($model, 'avatar');
        // 多个文件用getInstances，返回的是数组
        $model->attachments = UploadedFile::getInstances($model, 'attachments');

        if ($model->validate()) {
            // 处理单个文件上传
            if ($model->avatar) {
                $filePath = 'uploads/avatars/' . uniqid() . '.' . $model->avatar->extension;
                $model->avatar->saveAs($filePath);
                // 如果要存到数据库，存的是文件路径字符串，不是$model->avatar本身！
                $model->avatar_path = $filePath;
            }

            // 处理多个文件上传
            $filePaths = [];
            foreach ($model->attachments as $file) {
                $path = 'uploads/attachments/' . uniqid() . '.' . $file->extension;
                $file->saveAs($path);
                $filePaths[] = $path;
            }
            // 把路径数组转成字符串存到数据库（如果需要的话）
            $model->attachment_paths = implode(',', $filePaths);

            $model->save(false); // 因为avatar是临时属性，不需要验证，所以用save(false)
            return $this->redirect(['site/login']);
        }
    }

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

最容易踩的坑 #

很多人会犯的错误是：直接把$model->attachments（数组）赋值给数据库的字符串字段，比如$model->attachment_paths = $model->attachments;，这时候就会触发Array to string conversion——你得把数组转成字符串（比如用implode(',', $filePaths)），或者单独存到关联表。

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