Yii2查询where条件拼装详解

小云云

发布时间：2018-03-27 13:41:07

2780人浏览过

来源于php中文网

原创

熟悉Yii2的查询条件后，用Active Record查询数据非常方便。以下我们介绍where()方法当中，条件的拼装方式。

1 语法

Yii2用where()方法（当然还有其他方法）来实现条件筛选，语法：

public $this where ( $condition, $params = [] )

$params为可选参数，指定要绑定查询的值。

$condition为必选参数，$condition可以是字符串（如'id=1'）或者数组。

$condition为数组时，有两种格式：

哈希格式：['column1' => value1, 'column2' => value2, ...]
运算符格式：[operator, operand1, operand2, ...]

2 哈希格式

通常，哈希格式的查询条件生成这样的SQL语句：

column1=value1 AND column2=value2 AND ...

如果某个值是数组，就会生成IN语句。

如果某个值为null，会用ISNULL来生成语句。

例子：

['type' => 1, 'status' => 2]            
// 生成：(type = 1) AND (status = 2)['id' => [1, 2, 3], 'status' => 2]     
 // 生成：(id IN (1, 2, 3)) AND (status = 2)['status' => null]                     
  // 生成：status IS NULL

3 运算符格式

在运算符格式，Yii会根据指定的运算符生成SQL语句。

运算符有：and、or、not、between、not between、in、notin、like、or like、not like、ornot like、exists、notexists、>、<、=、>=、<=、!=等。

3.1 对比

['>', 'id', 1]                                        
// 生成：id > 1['<', 'id', 100]                                     
 // 生成：id < 100['=', 'id', 10]                                       
 // 生成：id = 10['>=', 'id', 1]                                     
   // 生成：id >= 1['<=', 'id', 100]                                   
       // 生成：id != 10

具体生成的SQL语句，运算符id会自动加上反斜杠引号`，运算数会自动转义。

3.2 and

['and', 'id' => 1, 'id' => 2]                       
 // 生成：id=1 AND id=2['and', 'id=1', 'id=2']                             
 // 生成：id=1 AND id=2['and', 'type=1', ['or', 'id=1', 'id=2']]            
 // 生成：type=1 AND (id=1 OR id=2)

在第2条和第3条语句中，列名称和搜索值未用键值关系指定，所以生成的SQL不会添加引号，也不会转义。

3.3 or

['or', ['type' => [7, 8, 9]], ['id' => [1, 2, 3]]]   
// 生成：(type IN (7, 8, 9) OR (id IN (1, 2, 3)))

3.4 not

['not', ['attribute' => null]]                       
// 生成：NOT (attribute IS NULL)

3.5 between和not between

['between', 'id', 1, 10]                           
  // 生成：id BETWEEN 1 AND 10['not between', 'id', 1, 10]                        
   // 生成：id NOT BETWEEN 1 AND 10

运算符后面的运算数1为数据表列名称，运算数2和运算数3分别为列值范围的最小值和最大值。

3.6 in和not in

['in', 'id', [1, 2, 3]]                               
// 生成：id IN (1, 2, 3)['not in', 'id', [1, 2, 3]]                          
 // 生成：id NOT IN (1, 2, 3)

运算符后面的运算数1为列名称或DB表达式，运算数2为数组，指定列值所在的范围。

这个方法会为值添加引号，并正确转义。

要生成混合IN条件，列名和列值都设置为数组，并且用列名为列值指定下标：

['in', ['id', 'name'], [['id' => 1, 'name' => 'foo'], ['id' => 2, 'name' => 'bar']]]  // 生成：(`id`, `name`) IN ((1, 'foo'), (2, 'bar'))

另外，还可以用子查询作为IN条件的值，如下：

['in', 'user_id', (new Query())->select('id')->from('users')->where(['active' => 1])]

3.7 like

['like', 'name', 'tester']                            
 // 生成：name LIKE '%tester%'['like', 'name', ['test', 'sample']]                  
  // 生成：name LIKE '%test%' AND name LIKE '%sample%'['like', 'name', '%tester', false]                    
   // 生成：name LIKE '%tester'

// 这是自定义查询方式，要传入值为false的运算数3，并且自行添加%

运算数后面的运算数1为列名称或DB表达式，运算数2为字符串或数组，指定列值查询条件。

这个方法会为值添加引号，并正确转义。

or like、not like、ornot like用法和like一样。

['or like', 'name', ['test', 'sample']]                 
// 生成：name LIKE '%test%' OR name LIKE '%sample%'['not like', 'name', 'tester']                          
// 生成：name NOT LIKE '%tester%'['or not like', 'name', ['test', 'sample']]             
// 生成：name NOT LIKE '%test%' OR name NOT LIKE '%sample%'

3.8 exists

['exists', (new Query())->select('id')->from('users')->where(['active' => 1])] 
// 生成：EXISTS (SELECT "id" FROM "users" WHERE "active"=1)

notexists用法和exists一样。

相关专题

TypeScript类型系统进阶与大型前端项目实践

本专题围绕 TypeScript 在大型前端项目中的应用展开，深入讲解类型系统设计与工程化开发方法。内容包括泛型与高级类型、类型推断机制、声明文件编写、模块化结构设计以及代码规范管理。通过真实项目案例分析，帮助开发者构建类型安全、结构清晰、易维护的前端工程体系，提高团队协作效率与代码质量。

2026.03.13

Python异步编程与Asyncio高并发应用实践

本专题围绕 Python 异步编程模型展开，深入讲解 Asyncio 框架的核心原理与应用实践。内容包括事件循环机制、协程任务调度、异步 IO 处理以及并发任务管理策略。通过构建高并发网络请求与异步数据处理案例，帮助开发者掌握 Python 在高并发场景中的高效开发方法，并提升系统资源利用率与整体运行性能。

2026.03.12

C# ASP.NET Core微服务架构与API网关实践

本专题围绕 C# 在现代后端架构中的微服务实践展开，系统讲解基于 ASP.NET Core 构建可扩展服务体系的核心方法。内容涵盖服务拆分策略、RESTful API 设计、服务间通信、API 网关统一入口管理以及服务治理机制。通过真实项目案例，帮助开发者掌握构建高可用微服务系统的关键技术，提高系统的可扩展性与维护效率。

178

2026.03.11

Go高并发任务调度与Goroutine池化实践

本专题围绕 Go 语言在高并发任务处理场景中的实践展开，系统讲解 Goroutine 调度模型、Channel 通信机制以及并发控制策略。内容包括任务队列设计、Goroutine 池化管理、资源限制控制以及并发任务的性能优化方法。通过实际案例演示，帮助开发者构建稳定高效的 Go 并发任务处理系统，提高系统在高负载环境下的处理能力与稳定性。

2026.03.10

Kotlin Android模块化架构与组件化开发实践

本专题围绕 Kotlin 在 Android 应用开发中的架构实践展开，重点讲解模块化设计与组件化开发的实现思路。内容包括项目模块拆分策略、公共组件封装、依赖管理优化、路由通信机制以及大型项目的工程化管理方法。通过真实项目案例分析，帮助开发者构建结构清晰、易扩展且维护成本低的 Android 应用架构体系，提升团队协作效率与项目迭代速度。

2026.03.09

JavaScript浏览器渲染机制与前端性能优化实践

本专题围绕 JavaScript 在浏览器中的执行与渲染机制展开，系统讲解 DOM 构建、CSSOM 解析、重排与重绘原理，以及关键渲染路径优化方法。内容涵盖事件循环机制、异步任务调度、资源加载优化、代码拆分与懒加载等性能优化策略。通过真实前端项目案例，帮助开发者理解浏览器底层工作原理，并掌握提升网页加载速度与交互体验的实用技巧。

102

2026.03.06

Rust内存安全机制与所有权模型深度实践

本专题围绕 Rust 语言核心特性展开，深入讲解所有权机制、借用规则、生命周期管理以及智能指针等关键概念。通过系统级开发案例，分析内存安全保障原理与零成本抽象优势，并结合并发场景讲解 Send 与 Sync 特性实现机制。帮助开发者真正理解 Rust 的设计哲学，掌握在高性能与安全性并重场景中的工程实践能力。

227

2026.03.05

PHP高性能API设计与Laravel服务架构实践

本专题围绕 PHP 在现代 Web 后端开发中的高性能实践展开，重点讲解基于 Laravel 框架构建可扩展 API 服务的核心方法。内容涵盖路由与中间件机制、服务容器与依赖注入、接口版本管理、缓存策略设计以及队列异步处理方案。同时结合高并发场景，深入分析性能瓶颈定位与优化思路，帮助开发者构建稳定、高效、易维护的 PHP 后端服务体系。

532

2026.03.04