Yii2中为ActiveForm实现类内置required规则的AJAX自定义验证

没问题，我帮你一步步搞定这个自定义年龄验证，让它和Yii2内置的required规则一样支持AJAX实时验证，体验完全一致～

Yii2的验证规则支持自定义方法，我们先在你的Model里添加年龄验证的逻辑，还要确保它能和其他内置规则协同工作：

class User extends ActiveRecord
{
    // 你的其他属性、场景定义等...

    public function rules()
    {
        return [
            // 内置必填规则，和你的自定义规则并行
            ['age', 'required'],
            // 注册自定义验证方法
            ['age', 'validateAge'],
        ];
    }

    /**
     * 自定义年龄验证逻辑
     * @param string $attribute 要验证的字段名（这里就是age）
     * @param array $params 规则的额外参数（可选）
     */
    public function validateAge($attribute, $params)
    {
        // 先检查前面的规则（比如required）有没有出错，避免无效验证
        if (!$this->hasErrors()) {
            if ($this->$attribute < 18) {
                // 添加错误信息，会自动被前端捕获显示
                $this->addError($attribute, '您必须年满18岁才能提交。');
            }
        }
    }
}

要让验证像required一样实时AJAX触发，必须在ActiveForm里开启AJAX验证开关：

<?php 
use yii\widgets\ActiveForm;
use yii\helpers\Html;

$form = ActiveForm::begin([
    'id' => 'user-form', // 表单ID，AJAX验证需要这个
    'enableAjaxValidation' => true, // 核心：开启AJAX实时验证
    'enableClientValidation' => true, // 可选：同时开启客户端验证，减少服务器请求
]); ?>

<?= $form->field($model, 'age')->textInput(['type' => 'number']) ?>

<?= Html::submitButton('提交', ['class' => 'btn btn-primary']) ?>

<?php ActiveForm::end(); ?>

Yii2需要在对应的Controller动作里处理AJAX验证的异步请求，代码很简单，直接集成到你的创建/更新动作里：

use yii\web\Response;
use yii\widgets\ActiveForm;

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

    // 处理AJAX验证请求：判断是否是AJAX，并且表单数据已提交
    if (Yii::$app->request->isAjax && $model->load(Yii::$app->request->post())) {
        Yii::$app->response->format = Response::FORMAT_JSON;
        // 自动触发所有验证规则（包括你的自定义validateAge）
        return ActiveForm::validate($model);
    }

    // 正常表单提交逻辑
    if ($model->load(Yii::$app->request->post()) && $model->save()) {
        return $this->redirect(['view', 'id' => $model->id]);
    }

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

如果想让用户输入时立刻在本地验证（不用等AJAX响应），可以给自定义规则加上客户端验证回调，这样体验更流畅：

修改Model里的rules，给validateAge规则加clientValidateCallback参数：

['age', 'validateAge', 
    'clientValidateCallback' => function ($attribute, $params, $model) {
        return <<<JS
            // 前端验证逻辑，和后端保持一致
            if (parseInt(value) < 18) {
                messages.push('您必须年满18岁才能提交。');
            }
JS;
    }
],

这样设置后，用户输入年龄时，前端会先做判断，没满18直接显示错误；同时服务器端依然会再验证一遍，防止恶意绕过前端的情况。

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