yii2模型场景机制通过场景标识符动态控制属性可写性、可见性及验证器激活状态;需重写scenarios()声明safe属性,rules()中用on/except限定规则作用范围,支持运行时setscenario切换,并可结合attributelabels()和message实现多场景差异化提示。

Yii2 的模型场景(scenario)机制,本质是为同一模型类在不同业务上下文中启用不同的验证规则和属性行为。它不是简单地“切换规则列表”,而是通过 场景标识符 控制属性的可写性、可见性及验证器的激活状态。
场景定义与默认行为
每个模型都继承自 yii\base\Model,默认拥有 default 场景。你可以在模型类中重写 scenarios() 方法来声明支持的场景及其对应的行为:
-
scenarios()返回一个数组,键是场景名,值是该场景下允许被赋值的属性列表(即safe属性) - 未列入该列表的属性,在该场景下调用
load()或批量赋值时会被忽略 - 验证规则是否生效,取决于规则中指定的
on参数是否包含当前场景
验证规则中的场景控制
在 rules() 方法中,每条规则可以附加 on 或 except 选项来限定其作用范围:
-
['username', 'required', 'on' => ['login', 'register']]:仅在 login 和 register 场景下校验 username 是否必填 -
['email', 'email', 'except' => ['login']]:除 login 外所有场景都校验 email 格式 - 不写
on和except的规则,默认对所有场景生效(包括 default)
动态设置与运行时切换
场景不是只在初始化时固定,而是在模型生命周期中随时可改:
-
$model->scenario = 'register';直接赋值即可切换 -
$model->setScenario('resetPassword');是更规范的写法,会触发事件和属性重置逻辑 - 调用
$model->load($post)前必须确保场景已设好,否则可能漏掉某些字段或验证 - 控制器中常见写法:
$model->scenario = $model->isNewRecord ? 'create' : 'update';
结合属性标签与错误提示
场景还可影响属性标签和错误信息的显示:
- 重写
attributeLabels(),根据$this->scenario返回不同中文名 - 在
rules()中为同一属性配置多个规则,用不同message配合on区分提示语 - 例如注册时用户名需唯一,登录时只需非空,两条规则可共存,靠场景隔离执行











