Yii2查询之where条件拼装

熟悉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，会用IS NULL来生成语句。

例子：

['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、not in、like、or like、not like、or not like、exists、not exists、>、<、=、>=、<=、!=等。

3.1 对比

['>', 'id', 1]                                        // 生成：id > 1
['<', 'id', 100]                                      // 生成：id < 100
['=', 'id', 10]                                       // 生成：id = 10
['>=', 'id', 1]                                       // 生成：id >= 1
['<=', 'id', 100]                                     // 生成：id <= 100
['!=', 'id', 10]                                      // 生成：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、or not 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)

not exists用法和exists一样。

参考地址：

1. http://www.yiiframework.com/doc-2.0/yii-db-query.html#where()-detail