在yii2中确保字段非空需配置required验证器:单字段用['字段名', 'required'],多字段用[['f1','f2'], 'required'];支持自定义message、on场景限定、skiponempty控制及when动态判断。

要在Yii2中确保某个字段在表单提交时不能为空,必须正确配置required验证器,否则模型验证会跳过空值检查导致数据异常。
基础用法:单个字段必填
在模型的rules()方法中添加一行规则:['字段名', 'required']。例如,让username字段必填,就写['username', 'required']。
这一步操作起来很简单,直接把规则数组加进去就行。
注意:required验证器默认不接受空字符串、null、0(数字零)、false,但会把字符串'0'、'false'视为非空——这是容易踩的坑,若业务允许'0'为合法值,需配合filter或自定义逻辑处理。
多字段共用一条required规则
把多个字段名放进一个数组里,再和'required'配对:[['title', 'content', 'category'], 'required']。
这种写法比逐条写更简洁,且所有字段共享同一套验证行为,比如统一提示信息或触发条件。
自定义错误提示与触发条件
方法一:指定message参数
写成['email', 'required', 'message' => '邮箱地址不能为空,请填写'],就能覆盖默认提示。
方法二:限定仅在特定场景生效
加上'on' => 'signup',表示只在signup场景下才校验该字段是否为空,其他场景(如update)则忽略此规则。
方法三:控制空值跳过逻辑
【skipOnEmpty => false】强制对空值也执行验证——比如某字段允许为空但一旦填了就必须合规,此时需关闭默认跳过机制。
高级控制:动态决定是否必填
第一步:在rules()中声明带when回调的required规则:['phone', 'required', 'when' => function ($model) { return $model->type === 'mobile'; }]
第二步:确保回调返回布尔值,true表示启用required校验,false则整条规则不触发——when优先级高于skipOnEmpty,只要它返回false,后续逻辑全不执行。
第三步:若需同时兼容空值判断,可在回调内部手动检查:return !empty($model->type) && $model->type === 'mobile';,避免因$type为null导致意外通过。











