Yii框架的模型场景怎么用_不同验证规则的应用场景【解答】

小浩同学_2213

小浩同学_2213

2026-04-07

991人浏览

原创

yii模型的scenario仅控制rules()中验证规则的触发条件,不负责字段过滤或权限控制;必须在load()或validate()前设置,且需配合safe/unsafe规则或空场景加载来实现数据安全。

yii框架的模型场景怎么用_不同验证规则的应用场景【解答】

场景(scenario)不是用来分组字段的

Yii 模型里的 scenario 本质是验证规则的开关集合,不是字段白名单或数据过滤器。设了 $model->scenario = 'create',不会自动剔除其他字段,也不会阻止你赋值 $model->updated_at —— 它只决定哪些 rules() 条目会被触发。

  • 常见错误:以为设了 'scenario' => ['update'] 就能防止用户提交 created_at 字段,结果数据库被恶意覆盖
  • 真正该配合用的是 safe 和 unsafe 验证规则,或者显式调用 $model->load($data, '')(空字符串禁用场景)再手动赋值
  • rules() 中每条规则末尾的 ['on' => ['create']] 才是生效条件,不写 on 就默认所有场景都跑

怎么定义和切换场景才不踩坑

场景名是纯字符串,Yii 不校验是否存在,拼错就等于没生效;而且切换必须在 load() 或 validate() 之前完成。

  • 定义场景推荐在模型类顶部加常量:const SCENARIO_CREATE = 'create';,避免散落字符串导致 typo
  • 切换时机很关键:在 $model->load($post) 后改 scenario 是无效的,因为 load() 内部已根据当时场景生成了安全属性列表
  • API 场景建议按动词 + 实体命名,比如 'api/update-profile',避免和控制器动作名冲突(如 'update' 可能被多个 action 复用)
  • 不要在 beforeValidate() 里动态改 scenario,验证流程已启动,规则早已筛选完毕

rules() 里 on / except 的参数差异直接影响验证范围

on 和 except 控制的是“这条规则是否参与当前场景”,不是“只在这几个场景运行”——它们互斥,不能同时出现。

Yii Framework 2.0.51
Yii Framework 2.0.51

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

下载
  • [['email'], 'email', 'on' => ['register', 'reset-password']]:仅当 scenario 是这两个之一时,才校验邮箱格式
  • [['status'], 'in', 'range' => [0,1], 'except' => ['create']]:除了 create 场景,其他都校验 status 是否为 0/1
  • 漏写 on 或 except 的规则会无条件执行,容易在 API 更新时意外触发旧验证(比如给 update 场景加了密码必填,但忘了限制 on)
  • 复合场景如 'on' => ['api/create', 'admin/create'] 是合法的,但注意字符串要完全匹配,'api/create' ≠ 'apicreate'

验证通过后,场景对后续操作基本没影响

一旦 validate() 返回 true,scenario 的使命就结束了。它不会影响 save() 行为、不会限制属性可写性、也不参与 AR 查询。

  • 别指望设了 scenario = 'admin' 就能绕过用户权限检查——那是业务逻辑,得自己在 beforeSave() 或 service 层处理
  • save(false) 会跳过验证,此时 scenario 完全无关;而 save(true) 会重新触发验证,用当前 scenario
  • 批量赋值(load())和单字段赋值($model->name = 'xxx')都不受 scenario 影响,只有验证和安全属性判定阶段才读取它

场景机制本身很轻,但容易误以为它承担了字段过滤、权限控制、流程分支等职责。其实它只管“哪几条规则该跑”,其余都得靠你手动补位。

相关文章

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

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

下载

相关标签:

yii yii框架

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

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6064

49

c语言const用法
c语言const用法

const是关键字,可以用于声明常量、函数参数中的const修饰符、const修饰函数返回值、const修饰指针。详细介绍:1、声明常量,const关键字可用于声明常量,常量的值在程序运行期间不可修改,常量可以是基本数据类型,如整数、浮点数、字符等,也可是自定义的数据类型;2、函数参数中的const修饰符,const关键字可用于函数的参数中,表示该参数在函数内部不可修改等等。

2023.09.20

2198

7

js 字符串转数组
js 字符串转数组

js字符串转数组的方法:1、使用“split()”方法;2、使用“Array.from()”方法;3、使用for循环遍历;4、使用“Array.split()”方法。本专题为大家提供js字符串转数组的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.03

1738

5

js截取字符串的方法
js截取字符串的方法

js截取字符串的方法有substring()方法、substr()方法、slice()方法、split()方法和slice()方法。本专题为大家提供字符串相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.04

2664

5

java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

2023.10.24

6064

49

字符串介绍
字符串介绍

字符串是一种数据类型,它可以是任何文本,包括字母、数字、符号等。字符串可以由不同的字符组成,例如空格、标点符号、数字等。在编程中,字符串通常用引号括起来,如单引号、双引号或反引号。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2023.11.24

5629

6

java读取文件转成字符串的方法
java读取文件转成字符串的方法

Java8引入了新的文件I/O API,使用java.nio.file.Files类读取文件内容更加方便。对于较旧版本的Java,可以使用java.io.FileReader和java.io.BufferedReader来读取文件。在这些方法中,你需要将文件路径替换为你的实际文件路径,并且可能需要处理可能的IOException异常。想了解更多java的相关内容,可以阅读本专题下面的文章。

2024.03.22

7294

16

php中定义字符串的方式
php中定义字符串的方式

php中定义字符串的方式:单引号;双引号;heredoc语法等等。想了解更多字符串的相关内容,可以阅读本专题下面的文章。

2024.04.29

10594

11

go语言字符串相关教程
go语言字符串相关教程

本专题整合了go语言字符串相关教程,阅读专题下面的文章了解更多详细内容。

2025.07.29

5419

17

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习