Yii 1.1 CDbCriteria 进阶：构建 NOT LIKE 查询条件

CDbCriteria 与 addSearchCondition 基础

Yii 1.1 框架提供了强大的 ActiveRecord 模式和 CDbCriteria 类，极大地简化了数据库查询的构建。其中，addSearchCondition 方法是进行模糊搜索的常用工具，它能方便地生成 WHERE property LIKE "%FOOBAR%" 这样的查询语句。

例如，要查询 property 字段包含 "FOOBAR" 的所有记录，可以这样实现：

$criteria = new CDbCriteria();
$criteria->addSearchCondition('property', 'FOOBAR');
$result = Table::model()->findAll($criteria);
// 这将生成类似 SELECT * FROM table WHERE property LIKE '%FOOBAR%' 的SQL

实现 NOT LIKE 查询条件

然而，在某些场景下，我们需要构建相反的条件，例如查询不包含特定关键词的数据，即 WHERE property NOT LIKE "%FOOBAR%"。addSearchCondition 方法的设计非常灵活，它允许我们通过指定其第五个参数来精确控制所使用的 SQL 比较操作符。

CDbCriteria::addSearchCondition() 方法的完整签名如下：

public CDbCriteria addSearchCondition(string $column, string $value, boolean $partialMatch=true, string $operator='AND', string $likeOperator='LIKE')

各个参数的含义如下：

阶跃AI

阶跃星辰旗下AI智能问答搜索助手

291

查看详情

• $column: 数据库列名，即要进行搜索的字段。
• $value: 要搜索的关键词或值。
• $partialMatch: 布尔值，如果为 true (默认)，则会在 $value 的前后添加 % 实现模糊匹配 (%value%)；如果为 false，则不添加。
• $operator: 逻辑操作符，用于连接当前条件与之前已添加的条件，通常是 'AND' (默认) 或 'OR'。
• $likeOperator: 关键参数。这是用于比较的 SQL 操作符。默认值是 'LIKE'。要实现 NOT LIKE，只需将其设置为 'NOT LIKE' 即可。

因此，要构建 SELECT * FROM table WHERE property NOT LIKE "%FOOBAR%" 这样的查询，可以这样实现：

$criteria = new CDbCriteria();
// 构建 NOT LIKE 查询
// 参数1: 列名 'property'
// 参数2: 关键词 'FOOBAR'
// 参数3: partialMatch 保持为 true (默认值，生成 %FOOBAR%)
// 参数4: operator 保持为 'AND' (默认值)
// 参数5: likeOperator 设置为 'NOT LIKE'
$criteria->addSearchCondition('property', 'FOOBAR', true, 'AND', 'NOT LIKE');

// 执行查询
$result = Table::model()->findAll($criteria);

这段代码会生成类似 WHERE property NOT LIKE '%FOOBAR%' 的 SQL 语句，精确满足了不包含特定关键词的查询需求。

注意事项与进阶应用

1. 性能考量： NOT LIKE 查询，尤其是在大数据量或未建立适当索引的列上执行时，可能会导致全表扫描，影响查询性能。在设计数据库和查询时应充分考虑这一点。对于频繁的 NOT LIKE 操作，考虑是否能通过其他方式（如使用精确匹配的反向逻辑、增加辅助字段或全文索引）来优化。
2. 操作符灵活性： $likeOperator 参数不仅限于 LIKE 和 NOT LIKE，您还可以传递其他有效的 SQL 比较操作符，例如 '=', '!=', '>', '<', 'IS NULL', 'IS NOT NULL' 等。但请注意，当使用非 LIKE 操作符时，$partialMatch 参数通常不再有意义，因为它仅影响 LIKE 语句中的 % 通配符。
3. 安全性： addSearchCondition 方法内部会对 $value 进行适当的 SQL 转义，以防止 SQL 注入。这使得它成为构建安全查询的首选方法。如果选择直接使用 addCondition 结合原始 SQL 字符串来构建复杂查询，务必自行进行参数绑定或转义，以确保数据安全。
4. 组合条件： addSearchCondition 可以与其他 CDbCriteria 方法（如 addCondition, compare, addInCondition, addBetweenCondition 等）组合使用，构建极其复杂的查询逻辑。这允许开发者以高度结构化和安全的方式构建任何所需的数据库查询。

总结

通过巧妙利用 CDbCriteria::addSearchCondition 方法的第五个参数 $likeOperator，开发者可以轻松地将默认的 LIKE 行为反转为 NOT LIKE，或者使用其他自定义的 SQL 比较操作符。这极大地增强了 Yii 1.1 中构建复杂查询的灵活性和表达能力，是提升应用数据检索能力的重要技巧。理解并善用这一特性，能够帮助您更高效、安全地处理各种数据库查询需求。

以上就是Yii 1.1 CDbCriteria 进阶：构建 NOT LIKE 查询条件的详细内容，更多请关注php中文网其它相关文章！