0

0

Yii框架的模型默认作用域_使用defaultScope添加全局条件【解答】

絕刀狂花

絕刀狂花

发布时间:2026-03-18 08:48:31

|

132人浏览过

|

来源于php中文网

原创

Yii 2.x+ 已移除 defaultScope,须重写模型 find() 方法并用 andWhere() 添加全局条件,命名 scope 必须是返回 Query 的 public static 方法,行为无法自动注入查询链。

yii框架的模型默认作用域_使用defaultscope添加全局条件【解答】

defaultScope 在 Yii 1.x 中有效,Yii 2.x+ 已移除

Yii 2.0 开始,defaultScope 方法被彻底废弃,模型类里定义它不会生效,也不会报错——这是最常踩的坑。官方改用 find() 静态方法 + where()andWhere() 搭配 BaseActiveRecord::find() 的重写来实现类似效果。

如果你在 Yii 2.1+ 项目里看到某处写了 defaultScope() 却发现软删除、租户 ID 过滤没起作用,大概率就是掉进这个兼容性陷阱了。

Yii 2.x 正确添加全局查询条件的方式

必须在模型的 find() 静态方法中显式追加条件,且要确保所有查询入口都走这个方法(比如 User::find()->one()User::find()->all()),直接调用 findOne()findAll() 不会触发。

  • 重写模型的 find() 方法,返回带默认条件的 Query 对象
  • parent::find()->andWhere(...) 而不是 where(),避免覆盖已有条件
  • 对关联查询(如 with('profile'))也生效,但要注意关联表字段不能直接在主模型 andWhere 里引用
  • 若需临时取消全局条件,用 User::find()->withoutDefaultScope()->one()(需自行实现该方法)
public static function find()
{
    return parent::find()->andWhere(['status' => self::STATUS_ACTIVE]);
}

为什么不用行为(Behavior)统一处理 soft-delete?

虽然可以写个 SoftDeleteBehavior 并 attach 到模型上,但它无法自动注入到每个 find() 调用中——行为不参与查询构建过程,只响应事件或扩展实例方法。你仍然得在 find() 里手动调用行为的过滤逻辑,反而增加耦合和出错概率。

MidReal AI
MidReal AI

MidReal AI是一款革命性的AI小说生成工具,同时也是一个文本互动冒险游戏平台。

下载

更实际的做法是:把通用过滤抽成静态方法,在 find() 里复用;或者用基类模型统一实现,子类按需覆写。

  • 行为适合做数据保存前后的钩子(如自动设 updated_at),不适合改查询结构
  • 全局条件本质是 Query 层的事,绕不开重写 find()
  • 多个全局条件叠加时(如租户 + 状态 + 可见范围),全堆在 find() 里比分散在行为里更容易调试和测试

注意 scope 和 defaultScope 的命名混淆

Yii 2.x 支持 named scopes(即 scenarios?不,是 scope 方法,如 active()),但它们和已废弃的 defaultScope 完全无关。有人误以为定义一个叫 defaultScope() 的普通方法就能生效,其实这只是个无意义的实例方法,对查询零影响。

  • 合法的命名 scope 必须是 public static 方法,返回 $this(Query 对象)
  • public static function deleted() { return self::find()->where(['deleted' => 1]); } 是有效的 scope
  • public function defaultScope() { ... }public static function defaultScope() { ... } 都不会被框架识别
  • 错误信息不会出现,查不到数据时才意识到条件根本没加进去
全局条件这事,核心就一条:Yii 2+ 没有 magic 入口,所有过滤必须显式出现在 Query 构建链路上。漏掉一次 find() 重写,或者误信某个“自动生效”的命名约定,后面排查起来都得翻半天日志。

热门AI工具

更多
DeepSeek
DeepSeek

幻方量化公司旗下的开源大模型平台

豆包大模型
豆包大模型

字节跳动自主研发的一系列大型语言模型

WorkBuddy
WorkBuddy

腾讯云推出的AI原生桌面智能体工作台

腾讯元宝
腾讯元宝

腾讯混元平台推出的AI助手

文心一言
文心一言

文心一言是百度开发的AI聊天机器人,通过对话可以生成各种形式的内容。

讯飞写作
讯飞写作

基于讯飞星火大模型的AI写作工具,可以快速生成新闻稿件、品宣文案、工作总结、心得体会等各种文文稿

即梦AI
即梦AI

一站式AI创作平台,免费AI图片和视频生成。

ChatGPT
ChatGPT

最最强大的AI聊天机器人程序,ChatGPT不单是聊天机器人,还能进行撰写邮件、视频脚本、文案、翻译、代码等任务。

相关专题

更多
堆和栈的区别
堆和栈的区别

堆和栈的区别:1、内存分配方式不同;2、大小不同;3、数据访问方式不同;4、数据的生命周期。本专题为大家提供堆和栈的区别的相关的文章、下载、课程内容,供大家免费下载体验。

448

2023.07.18

堆和栈区别
堆和栈区别

堆(Heap)和栈(Stack)是计算机中两种常见的内存分配机制。它们在内存管理的方式、分配方式以及使用场景上有很大的区别。本文将详细介绍堆和栈的特点、区别以及各自的使用场景。php中文网给大家带来了相关的教程以及文章欢迎大家前来学习阅读。

606

2023.08.10

数据库Delete用法
数据库Delete用法

数据库Delete用法:1、删除单条记录;2、删除多条记录;3、删除所有记录;4、删除特定条件的记录。更多关于数据库Delete的内容,大家可以访问下面的文章。

290

2023.11.13

drop和delete的区别
drop和delete的区别

drop和delete的区别:1、功能与用途;2、操作对象;3、可逆性;4、空间释放;5、执行速度与效率;6、与其他命令的交互;7、影响的持久性;8、语法和执行;9、触发器与约束;10、事务处理。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

222

2023.12.29

function是什么
function是什么

function是函数的意思,是一段具有特定功能的可重复使用的代码块,是程序的基本组成单元之一,可以接受输入参数,执行特定的操作,并返回结果。本专题为大家提供function是什么的相关的文章、下载、课程内容,供大家免费下载体验。

500

2023.08.04

js函数function用法
js函数function用法

js函数function用法有:1、声明函数;2、调用函数;3、函数参数;4、函数返回值;5、匿名函数;6、函数作为参数;7、函数作用域;8、递归函数。本专题提供js函数function用法的相关文章内容,大家可以免费阅读。

167

2023.10.07

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

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

91

2025.09.04

Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建
Nginx跨平台安装实操指南:Windows、macOS与Linux环境快速搭建

本指南详解Nginx在Windows、macOS及Linux系统的安装全流程。涵盖官方包解压、Homebrew一键部署、APT/YUM源配置及Docker容器化方案。无论新手或开发者,均可快速搭建运行环境,掌握跨平台核心指令,为后续配置与调优奠定坚实基础。

10

2026.03.16

chatgpt使用指南
chatgpt使用指南

本专题整合了chatgpt使用教程、新手使用说明等等相关内容,阅读专题下面的文章了解更多详细内容。

22

2026.03.16

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号