Yii2中验证用户名需组合filter、string、match规则，支持自定义方法和场景化校验：trim去空格，string限长3–16，match正则允字母数字下划线中文（/u不可少）；可扩展validateUsernameFormat防重复字符与敏感词；注册与修改需分SCENARIO，避免规则冲突。
在Yii2中验证用户名格式，需防止用户输入空格、特殊符号或过短字符串，避免后续登录异常或数据库存储失败。
用内置string和match验证器组合校验
第一步：在模型的rules()方法中添加两条规则——先用filter去首尾空格，再用string限定长度，最后用match正则限制字符范围：
[['username'], 'filter', 'filter' => 'trim'],
[['username'], 'string', 'min' => 3, 'max' => 16, 'message' => '用户名长度必须为3–16个字符'],
[['username'], 'match', 'pattern' => '/^[a-zA-Z0-9_x{4e00}-x{9fa5}]+$/u', 'message' => '用户名只能包含字母、数字、下划线或中文'],
注意：正则末尾的/u修饰符不可省略，否则中文匹配会失效；若不加该修饰符，x{4e00}-x{9fa5}将无法正确识别Unicode汉字区间。
用自定义验证方法实现更灵活逻辑
当需要动态判断（如禁止连续重复字符、排除敏感词、校验拼音首字母等），直接写验证方法比堆砌正则更清晰可靠：
在模型类中添加方法：
public function validateUsernameFormat($attribute, $params)
{
if (preg_match('/(.)\1{2,}/', $this->$attribute)) {
$this->addError($attribute, '用户名不能包含连续3个以上相同字符');
}
if (strpos($this->$attribute, 'admin') !== false || strpos($this->$attribute, 'root') !== false) {
$this->addError($attribute, '用户名不能包含敏感词');
}
}
然后在rules()中声明：[['username'], 'validateUsernameFormat']。
结合场景（scenario）做差异化校验
注册与修改用户名的格式要求常不同——注册时需严格唯一+格式，修改时可能只允许改大小写或微调，此时必须绑定场景：
① 定义场景名，在模型顶部声明常量：const SCENARIO_REGISTER = 'register'; const SCENARIO_UPDATE = 'update';
② 在scenarios()方法中指定各场景的活动属性：
public function scenarios()
{
return [
self::SCENARIO_REGISTER => ['username', 'email', 'password'],
self::SCENARIO_UPDATE => ['username'],
];
}
③ 在rules()中按场景挂载不同规则：
[['username'], 'string', 'min' => 3, 'on' => self::SCENARIO_REGISTER],
[['username'], 'string', 'min' => 2, 'on' => self::SCENARIO_UPDATE],
[['username'], 'match', 'pattern' => '/^[a-z0-9_]+$/i', 'on' => self::SCENARIO_REGISTER],
[['username'], 'match', 'pattern' => '/^[a-zA-Z0-9_]+$/u', 'on' => self::SCENARIO_UPDATE],
这样注册时强制小写英文+数字+下划线，而修改时允许保留原有大小写——【不设场景会导致load()赋值失败或validate()误触发无关规则】。
