Yii2自定义验证区分新增修改参数校验-php教程-PHP中文网

yii2中应通过scenario机制区分新增和修改场景：在scenarios()定义场景、rules()按场景配置规则、自定义验证方法中用$this->scenario判断、控制器中load前显式设置场景，避免依赖isnewrecord。

yii2自定义验证区分新增修改参数校验

在 Yii2 中，自定义验证时区分「新增」和「修改」场景，关键在于利用模型的 scenario（场景） 机制，配合 rules() 中的场景限定和自定义验证方法中的逻辑判断，而非硬编码判断 $this->isNewRecord —— 因为它在表单提交后可能已被重置或不准确（如批量赋值、手动设置主键等）。

一、定义不同场景并绑定规则

在模型中明确声明新增（create）和修改（update）两个场景，并在 rules() 中按场景指定验证规则：

新增时要求必填字段（如 username、email），且需唯一性校验；
修改时允许部分字段为空，但对敏感字段（如 password）做条件验证（仅当有输入才校验格式）；
某些字段（如 status）在新增时设默认值，修改时才允许编辑。

示例：

public function scenarios()
{
    $scenarios = parent::scenarios();
    $scenarios['create'] = ['username', 'email', 'password'];
    $scenarios['update'] = ['username', 'email', 'password', 'status'];
    return $scenarios;
}

public function rules()
{
    return [
        [['username', 'email'], 'required', 'on' => ['create']],
        [['username', 'email'], 'required', 'on' => ['update']], // 可按需调整
        ['email', 'email'],
        ['email', 'unique', 'on' => ['create', 'update'], 'targetClass' => User::class],
        ['password', 'string', 'min' => 6, 'on' => ['create']],
        ['password', 'string', 'min' => 6, 'skipOnEmpty' => true, 'on' => ['update']],
    ];
}

二、在自定义验证方法中识别当前场景

若需更复杂的逻辑（如“修改时邮箱变更需重新验证”），应在自定义验证方法里通过 $this->scenario 判断，而不是依赖 isNewRecord：

Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板，适合旧项目兼容、升级验证和开发测试。

下载

public function validateEmailOnUpdate($attribute, $params)
{
    if ($this->scenario === 'update' && $this->isAttributeChanged('email')) {
        // 检查新邮箱是否已存在（排除自己）
        $exists = User::find()
            ->where(['email' => $this->email])
            ->andWhere(['!=', 'id', $this->id])
            ->exists();
        if ($exists) {
            $this->addError($attribute, '该邮箱已被其他用户使用');
        }
    }
}

// 在 rules() 中注册
['email', 'validateEmailOnUpdate', 'on' => 'update'],

三、控制器中正确设置场景

务必在控制器中显式指定场景，否则默认使用 default 场景（通常对应全部属性，易导致验证失控）：

新增：使用 $model->setScenario('create') 或直接构造时传入；
修改：先 findModel()，再 $model->setScenario('update')；
避免用 $model->load($post) 后再改场景——此时属性已批量赋值，可能跳过场景过滤。

示例：

// 创建
$model = new User(['scenario' => 'create']);
if ($model->load(Yii::$app->request->post()) && $model->validate()) { ... }

// 更新
$model = User::findOne($id);
$model->setScenario('update'); // 必须在 load 前或刚实例化后设
if ($model->load(Yii::$app->request->post()) && $model->validate()) { ... }