Yii2自定义表单验证需扩展验证规则：可在模型中定义validate开头的方法，或创建继承Validator的独立验证器类；后者支持复用、参数配置及前后端一致验证。
Yii2 实现自定义表单参数验证，核心在于**扩展验证规则**，既可通过模型类中定义 自定义验证方法，也可通过创建 独立验证器类 复用逻辑。关键不是“写个函数就完事”，而是让验证能融入 Yii2 的验证生命周期（如支持错误收集、客户端验证、属性绑定等）。
在模型中定义自定义验证方法
适合逻辑简单、仅用于当前模型的场景。需满足两个条件：
- 方法名以 validate 开头（如
validateMobile） - 方法接收一个
$attribute参数，并在验证失败时调用$this->addError($attribute, $message)
示例：验证手机号是否已存在且格式正确
public function rules()
{
return [
['mobile', 'required'],
['mobile', 'validateMobile'], // 调用自定义方法
];
}
public function validateMobile($attribute)
{
$value = $this->$attribute;
if (!preg_match('/^1[3-9]\d{9}$/', $value)) {
$this->addError($attribute, '手机号格式不正确');
return;
}
if (User::find()->where(['mobile' => $value])->exists()) {
$this->addError($attribute, '该手机号已被注册');
}
}
创建独立验证器类（推荐复用场景）
当验证逻辑需跨多个模型、或需配置参数（如指定字段、错误码、数据库连接）时，应继承 yii\validators\Validator 或其子类（如 yii\validators\RegularExpressionValidator）。
- 重写
validateAttribute()方法处理单属性验证 - 可选重写
clientValidateAttribute()支持 JS 前端验证 - 在
rules()中像内置验证器一样使用，支持传参
示例：一个可配置长度范围的中文姓名验证器
// components/ChineseNameValidator.php
namespace app\components;
use yii\validators\Validator;
class ChineseNameValidator extends Validator
{
public $minLength = 2;
public $maxLength = 10;
public function validateAttribute($model, $attribute)
{
$value = $model->$attribute;
if (!is_string($value) || mb_strlen($value, 'UTF-8') < $this->minLength
|| mb_strlen($value, 'UTF-8') > $this->maxLength) {
$this->addError($model, $attribute, '姓名长度应在 {min} 到 {max} 个汉字之间', [
'min' => $this->minLength,
'max' => $this->maxLength,
]);
}
if (!preg_match('/^[\x{4e00}-\x{9fa5}]+$/u', $value)) {
$this->addError($model, $attribute, '姓名只能包含中文字符');
}
}
}
在模型中使用：
public function rules()
{
return [
['name', 'app\components\ChineseNameValidator', 'minLength' => 2, 'maxLength' => 8],
];
}
配合 ActiveForm 实现前后端一致验证
若希望前端也校验（如手机号正则、姓名长度），可在自定义验证器中添加 JavaScript 支持：
- 重写
clientValidateAttribute()，返回 JS 校验代码字符串 - 确保对应 JS 逻辑与 PHP 端一致（尤其注意 Unicode、空格、编码差异）
- Yii2 会自动把验证器配置（如
minLength）注入到 JS 变量中
延续上面的 ChineseNameValidator，补充前端验证：
public function clientValidateAttribute($model, $attribute, $view)
{
$options = [
'min' => $this->minLength,
'max' => $this->maxLength,
'message' => $this->message ?: '姓名长度或格式不正确',
];
return <<<JS
if (value.length < {$options['min']} || value.length > {$options['max']}) {
messages.push({$options['message']});
} else if (!/^[\u4e00-\u9fa5]+$/.test(value)) {
messages.push({$options['message']});
}
JS;
}
注意验证时机与数据类型转换
表单提交的数据默认是字符串，但模型属性可能声明为整型、布尔等。Yii2 在验证前会尝试类型转换（由 filter 规则或 attributes() 定义控制）。若自定义验证依赖原始输入（如判断是否为空字符串而非 null），建议：
- 在
beforeValidate()中保存原始值 - 或使用
$model->getDirtyAttributes()辅助判断 - 避免在验证方法中直接修改属性值（除非明确需要）
例如防止空格干扰的手机号验证，可先 trim 再验证，但需同步更新属性值：
public function beforeValidate()
{
if ($this->hasAttribute('mobile')) {
$this->mobile = trim($this->mobile);
}
return parent::beforeValidate();
}
