Yii2回调函数实现自定义参数验证方法-php教程-PHP中文网

yii2中可用回调函数实现灵活参数验证，支持匿名函数或模型方法，需手动调用adderror()，可结合场景和动态参数定制逻辑。

yii2回调函数实现自定义参数验证方法

在 Yii2 中，可以通过回调函数实现灵活的自定义参数验证，适用于模型（Model）或表单验证场景。核心是使用 Validator::addRule() 或直接在规则数组中定义 function 类型的验证器。

在 rules() 中直接使用匿名函数

最常用的方式是在模型的 rules() 方法中，为某个属性指定一个匿名函数作为验证逻辑：

函数接收三个参数：$attribute（当前字段名）、$params（额外传入的配置）、$validator（当前 Validator 实例）
若验证失败，需手动调用 $this->addError($attribute, $message)
不返回值，也不抛异常，Yii 会根据是否有 error 判断是否通过

示例：验证手机号是否已存在且非当前用户本人

public function rules()
{
    return [
        // 其他规则...
        ['phone', function ($attribute, $params, $validator) {
            $user = User::find()->where(['phone' => $this->$attribute])->one();
            if ($user && $user->id !== $this->id) {
                $this->addError($attribute, '该手机号已被其他用户注册');
            }
        }],
    ];
}

封装为可复用的回调方法

将验证逻辑提取为模型中的普通方法，便于测试和复用：

Yii Framework 2.0.51

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

下载

方法必须是 public 或 protected，且签名与匿名函数一致
在 rules() 中以字符串形式引用方法名
可通过 $params 传递动态参数，如场景、排除 ID 等

示例：

public function validatePhoneUniqueness($attribute, $params, $validator)
{
    $query = User::find()->where([$attribute => $this->$attribute]);
    if (!empty($params['exceptId'])) {
        $query->andWhere(['!=', 'id', $params['exceptId']]);
    }
    if ($query->exists()) {
        $this->addError($attribute, $params['message'] ?? '该值已存在');
    }
}

public function rules()
{
    return [
        ['phone', 'validatePhoneUniqueness', 'exceptId' => $this->id],
    ];
}

配合场景（scenario）做条件验证

回调函数内可结合 $this->scenario 控制不同场景下的验证行为：

例如注册时严格校验唯一性，编辑时跳过当前用户
也可根据场景加载不同参数，避免硬编码

示例：

['email', function ($attr, $params, $v) {
    if ($this->scenario === 'create') {
        $exists = User::find()->where(['email' => $this->$attr])->exists();
        if ($exists) {
            $this->addError($attr, '邮箱已被注册');
        }
    } elseif ($this->scenario === 'update') {
        $exists = User::find()
            ->where(['email' => $this->$attr])
            ->andWhere(['!=', 'id', $this->id])
            ->exists();
        if ($exists) {
            $this->addError($attr, '邮箱已被其他用户使用');
        }
    }
}]