讲师中心 微信公众号
AI工具推荐 视频效率加速

Yii框架根据数组条件查询数据库记录怎么实现

小雪同学_1155

小雪同学_1155

发布时间:2026-08-20 10:33:37

|

302人浏览过

|

来源于php中文网

原创

Yii2中数组条件查询默认为AND逻辑,支持键值对等值匹配及['operator','field',value]格式实现IN、LIKE等操作,NULL需显式写为null,避免SQL注入。

yii框架根据数组条件查询数据库记录怎么实现

Yii2 中用数组条件查询 ActiveRecord

Yii2 的 ActiveRecord 支持直接传入关联数组作为查询条件,这是最常用也最安全的方式。数组键是字段名,值是匹配内容,框架会自动参数化处理,避免 SQL 注入。

比如查 User 表中状态为 1 且类型为 'admin' 的记录:

$users = User::find()
    ->where(['status' => 1, 'type' => 'admin'])
    ->all();

注意:where() 接收的数组默认是「AND」逻辑;若需 OR,得显式用 ['or', ...] 结构,例如:

->where(['or', ['status' => 0], ['status' => 2]])
  • 字符串字段建议用 trim() 或数据库层面的 TRIM() 处理前后空格,数组条件本身不自动 trim
  • NULL 值匹配要写成 ['field' => null],不是 'field' => '',否则可能查不到空值记录
  • 字段名别用驼峰(如 userName),除非已配置 tableName() 或启用驼峰转下划线映射

Yii2 数组条件里的操作符怎么写

纯键值对只能做等值匹配。要实现 IN、LIKE、BETWEEN 等,必须用带操作符的数组格式:['operator', 'field', value]。

常见写法:

// IN 查询
->where(['in', 'id', [1, 2, 3]])

// LIKE(自动加 %)
->where(['like', 'name', 'john'])

// 不区分大小写的 LIKE(MySQL 下生效)
->where(['ilike', 'email', 'gmail'])

// 大于等于
->where(['>=', 'created_at', '2024-01-01'])

// BETWEEN
->where(['between', 'age', 18, 60])
  • like 默认在前后加 %,如需只前缀匹配,用 ['like', 'name', 'john', false] 关闭自动补全
  • ilike 在 PostgreSQL 中原生支持,在 MySQL 中会被转成 LOWER() 包裹,有性能影响
  • 多个操作符嵌套时(如 ['or', ['=', 'a', 1], ['in', 'b', [2,3]]]),括号层级要对齐,少一个中括号就报错

Yii3 里数组条件写法有变化吗

有。Yii3 的 Query 和 ActiveRecord 查询接口更严格,不再接受裸数组作为 where() 参数,默认只认 ExpressionInterface 或字符串条件。但可通过 yii\db\conditions\HashCondition 显式构造数组条件。

Yii Framework 2.0.51
Yii Framework 2.0.51

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

下载

实际用法变成:

use yii\db\conditions\HashCondition;

$query = User::find()->where(new HashCondition(['status' => 1]));

或者更常见的——直接用链式方法替代数组:

->andWhere(['=', 'status', 1])
->andWhere(['=', 'type', 'admin'])
  • Yii3 不再隐式识别 ['in', ...] 这类数组,必须用 yii\db\conditions\InCondition 等具体类
  • 升级项目时,所有旧的数组条件调用都要检查,否则静默失效或抛出 InvalidConfigException
  • 如果混用 Yii2 和 Yii3 组件(比如只升级 DB 层),数组条件行为可能不一致,建议统一抽象层

数组条件和原生 SQL 混用容易出什么问题

当数组条件和字符串条件(如 'status = 1 AND name LIKE "%a%"')混用时,Yii 会把它们拼进同一 WHERE 子句,但参数绑定顺序可能错乱,导致 SQL 错误或查到意外数据。

典型翻车场景:

->where(['status' => 1])
->andWhere('name LIKE :pattern')
->addParams([':pattern' => '%test%'])

看起来没问题,但若前面的数组条件触发了内部参数重排(比如用了 in),:pattern 可能被覆盖或丢失绑定。

  • 优先全部用数组条件,避免字符串拼接
  • 真要混用,确保 addParams() 在所有 where() 调用之后执行
  • 调试时可用 $query->createCommand()->getRawSql() 看最终 SQL,但注意它不显示参数值,得结合日志看绑定参数
数组条件看着简单,但字段名拼写、NULL 判断、操作符语法、框架版本差异这四点,是线上查不到数据时最常卡住的地方。

热门AI工具

更多
Seko
Seko Hot

一款AI视频创作工具,主要用于商汤科技推出的创编一体的AI短视频创作Agent,适合需要提升相关任务效率的用户。

音述AI
音述AI Hot

一款AI音频处理工具,主要用于音述AI是一个以“用声音述说故事”为核心的 AI 音乐创作与声音分享社区,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

SkildArt
SkildArt Hot

SkildArt是一款AI文本写作工具,一站式 AI 视觉创作平台。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

讯飞绘文

讯飞绘文是一款由科大讯飞推出的一站式 AIGC 内容运营平台。

蛙蛙写作

一款AI论文写作工具,主要用于超级AI智能写作助手,适合需要提升相关任务效率的用户。

AionClaw
AionClaw Hot

AionClaw是一款面向办公、创作和编程任务的AI桌面智能体。

相关专题

更多
PHP Yii框架专题
PHP Yii框架专题

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

3070

2025.09.04

Gradle插件开发入门教程
Gradle插件开发入门教程

本专题介绍Gradle插件开发的基本流程,涵盖插件类编写、自定义任务注册、扩展参数设计和插件应用方法,帮助你理解插件如何组织构建逻辑,减少多个项目之间的重复配置。

40

2026.10.22

Gradle Wrapper配置教程
Gradle Wrapper配置教程

本专题介绍Gradle Wrapper的基本作用,涵盖文件组成、生成方法、版本配置和任务调用,帮助你理解项目如何使用指定的Gradle版本,减少不同开发环境带来的构建差异。

20

2026.10.22

Golangci-lint检查器使用教程
Golangci-lint检查器使用教程

本专题整理Golangci-lint常用Linters的用途与配置方法,覆盖错误处理、无效代码、安全、复杂度、命名和依赖检查,帮助项目合理选规则。

20

2026.10.22

Gradle怎么构建Java项目
Gradle怎么构建Java项目

本专题介绍Gradle Java项目构建方法,涵盖Java插件配置、依赖声明、源码编译、测试执行和打包检查,帮助你理解各阶段的任务关系,逐步完成项目构建。

0

2026.10.22

PHP时间戳漏洞修复教程
PHP时间戳漏洞修复教程

本专题汇总PHP常见时间戳漏洞,包括2038年溢出、时区漂移、时间戳伪造、重放攻击、时间盲注与日志审计失效等,并给出升级64位环境、使用 DateTimeImmutable、统一UTC、严格超时校验、预处理绑定、hash_equals 比对等修复方案,帮助开发者快速排查和加固时间相关代码。

20

2026.10.22

Golangci-lint配置文件与规则设置
Golangci-lint配置文件与规则设置

本专题聚焦Golangci-lint YAML配置文件,讲清运行参数、规则启停、目录排除、问题过滤及严重级别设置,便于团队统一检查标准。

20

2026.10.22

Golangci-lint安装与入门教程
Golangci-lint安装与入门教程

本专题讲解Golangci-lint的安装、初始化、基础命令和首次代码检查,覆盖本地环境、Docker及多平台用法,帮助Go开发者快速上手。

20

2026.10.22

PHP2Shell高危漏洞修复教程
PHP2Shell高危漏洞修复教程

PHP2Shell漏洞是什么,哪些PHP版本和运行环境会受到影响,服务器应该如何检测与修复?本专题提供版本自查脚本、Linux与Docker升级命令、PHP-FPM和Apache排查步骤,以及修复验证、临时缓解和应急响应方案。

140

2026.10.22

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共22课时 | 9.3万人学习

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

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn