Yii2 模型场景 scenario,不同场景下验证规则动态生效配置

风明大大_7720

风明大大_7720

2026-10-03

512人浏览

原创

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

yii2 模型场景 scenario,不同场景下验证规则动态生效配置

Yii2 的模型场景(scenario)机制,本质是为同一模型类在不同业务上下文中启用不同的验证规则和属性行为。它不是简单地“切换规则列表”,而是通过 场景标识符 控制属性的可写性、可见性及验证器的激活状态。

场景定义与默认行为

每个模型都继承自 yii\base\Model,默认拥有 default 场景。你可以在模型类中重写 scenarios() 方法来声明支持的场景及其对应的行为:

  • scenarios() 返回一个数组,键是场景名,值是该场景下允许被赋值的属性列表(即 safe 属性)
  • 未列入该列表的属性,在该场景下调用 load() 或批量赋值时会被忽略
  • 验证规则是否生效,取决于规则中指定的 on 参数是否包含当前场景

验证规则中的场景控制

在 rules() 方法中,每条规则可以附加 on 或 except 选项来限定其作用范围:

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
  • ['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 区分提示语
  • 例如注册时用户名需唯一,登录时只需非空,两条规则可共存,靠场景隔离执行

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

yii框架 yii2 yii

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
go语言 面向对象
go语言 面向对象

本专题整合了go语言面向对象相关内容,阅读专题下面的文章了解更多详细内容。

2025.09.05

5595

14

java面向对象
java面向对象

本专题整合了java面向对象相关内容,阅读专题下面的文章了解更多详细内容。

2025.11.27

302

13

C++ 面向对象编程与设计模式实践
C++ 面向对象编程与设计模式实践

本专题整合了 C++ 面向对象编程的核心机制,涵盖类的定义与访问控制、构造函数与析构函数、拷贝语义与移动语义、继承与虚函数多态、抽象类与接口、运算符重载、友元函数等关键知识点,同时结合单例模式、工厂模式、观察者模式、策略模式等常用设计模式的 C++ 实现,帮助开发者写出结构清晰、易于维护的面向对象代码。

2026.04.09

324

30

Java 面向对象与核心编程机制
Java 面向对象与核心编程机制

系统讲解 Java 面向对象编程的核心知识体系,涵盖类的定义与封装、构造方法与 this/super 关键字、继承与方法重写、多态与向上向下转型、抽象类与接口的区别与设计原则、异常处理机制(try-catch-finally / 自定义异常)、泛型的类型参数与通配符、集合框架(List/Set/Map)的使用与遍历方式,帮助开发者全面掌握 Java 程序设计的核心机制与面向对象思维。

2026.04.17

203

15

ThinkPHP表单验证与数据安全处理实战
ThinkPHP表单验证与数据安全处理实战

本专题聚焦 ThinkPHP 在表单处理中的验证与安全机制,系统讲解验证器使用、自定义规则、场景验证以及错误提示处理。内容涵盖 XSS 防护、SQL 注入防御、数据过滤与输入校验等关键安全措施。通过实际案例,帮助开发者构建安全可靠的数据处理流程。

2026.03.30

201

20

PHP Yii框架专题
PHP Yii框架专题

本专题专注于PHP主流框架Yii的应用,系统讲解MVC架构、路由机制、数据库操作、表单处理、安全验证与RESTful API 开发等核心内容。通过电商网站、后台管理系统与内容管理平台等实战项目,帮助学员快速掌握Yii框架的开发技巧与实战经验。

2025.09.04

2890

22

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

20

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

40

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

20

12

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习

Yii2框架基础视频教程
Yii2框架基础视频教程

共22课时 | 2.8万人学习