Yii 1.1 中 CDbCriteria 实现 NOT LIKE 查询

本文详细介绍了在 Yii 1.1 框架中，如何利用 CDbCriteria 的 addSearchCondition 方法实现 SQL 中的 ‘NOT LIKE’ 条件查询。通过深入解析 addSearchCondition 方法的第五个参数，即操作符参数，读者将学习如何灵活地构建反向或否定查询，从而高效地筛选不符合特定模式的数据，提升数据库查询的精确性和灵活性。

在 yii 1.1 框架中，cdbcriteria 是构建数据库查询条件的核心组件。它提供了一系列方法来方便地构造 sql where 子句，例如 addcondition、addincondition 以及用于模糊匹配的 addsearchcondition。通常情况下，addsearchcondition 方法被用来生成 like 条件，以匹配包含特定子字符串的数据。然而，在某些场景下，我们需要查询不包含特定模式的数据，即实现 sql 中的 not like 操作。

使用 addSearchCondition 实现 NOT LIKE 查询

CDbCriteria 的 addSearchCondition 方法提供了一个非常灵活的参数，允许我们指定自定义的 LIKE 操作符，从而轻松实现 NOT LIKE 逻辑。该方法的完整签名如下：

addSearchCondition(string $column, mixed $value, boolean $partialMatch=false, string $operator='AND', string $likeOperator='LIKE')

其中，第五个参数 $likeOperator 便是实现 NOT LIKE 关键所在。默认情况下，它的值为 ‘LIKE’。通过将其设置为 ‘NOT LIKE’，我们就可以反转匹配逻辑。

以下是一个具体的示例，演示如何查询 property 字段不包含字符串 “FOOBAR” 的所有记录：

// 实例化 CDbCriteria 对象 $criteria = new CDbCriteria();  // 使用 addSearchCondition 方法构建 NOT LIKE 查询 // 参数说明： // 1. 'property': 要查询的字段名 // 2. 'FOOBAR': 匹配的关键字 // 3. true: 表示进行部分匹配，即会在关键字前后添加 '%'，生成 "%FOOBAR%" // 4. 'AND': 逻辑操作符，表示与之前的条件使用 AND 连接（此处为第一个条件，所以影响不大） // 5. 'NOT LIKE': 关键所在，指定使用 NOT LIKE 操作符 $criteria->addSearchCondition('property', 'FOOBAR', true, 'AND', 'NOT LIKE');  // 执行查询 $result = Table::model()->findAll($criteria);  // 此时生成的 SQL 大致为： // SELECT * FROM `table` WHERE property NOT LIKE "%FOOBAR%"

参数详解

为了更好地理解上述示例，我们来详细解析 addSearchCondition 方法的各个参数：

1. $column (string): 必需。指定要应用搜索条件的数据库列名。
2. $value (mixed): 必需。指定要搜索的值。
3. $partialMatch (boolean): 可选，默认为 false。
   • 如果设置为 true，则 $value 会被自动包裹在百分号 % 中（例如，%value%），实现模糊匹配。
   • 如果设置为 false，则 $value 会被精确匹配，即 LIKE ‘value’ 或 NOT LIKE ‘value’。
4. $operator (string): 可选，默认为 ‘AND’。
   • 指定当前条件与前一个条件之间的逻辑操作符，可以是 ‘AND’ 或 ‘OR’。
5. $likeOperator (string): 可选，默认为 ‘LIKE’。
   • 这是实现 NOT LIKE 的核心参数。 通过将其设置为 ‘NOT LIKE’，可以将模糊匹配操作符从 LIKE 切换为 NOT LIKE。你也可以在这里指定其他数据库支持的模糊匹配操作符，例如 ILIKE（通常用于 PostgreSQL 的不区分大小写匹配）。

注意事项

• Yii 版本兼容性: 本文的解决方案适用于 Yii 1.1 版本。在 Yii 2.x 中，yiidbQuery 和 yiidbActiveQuery 提供了不同的查询构建方式，例如使用 andWhere([‘not like’, ‘property’, ‘FOOBAR’])。
• 性能考量: NOT LIKE 查询，尤其是当 $value 以百分号开头（即 LIKE ‘%value’ 或 NOT LIKE ‘%value’）时，通常无法有效利用数据库索引。这可能导致全表扫描，从而影响大型数据集上的查询性能。在设计数据库和查询时，应考虑是否可以通过其他方式（如使用精确匹配、枚举类型、全文索引等）优化此类查询。
• SQL 注入: CDbCriteria 和 addSearchCondition 方法会自动处理值的转义，从而有效防止 SQL 注入攻击。因此，直接传入用户输入的值是安全的。
• 多条件组合: 你可以继续链式调用 addSearchCondition 或其他 CDbCriteria 方法来构建更复杂的查询条件。$operator 参数将决定这些条件如何组合。

总结

CDbCriteria 的 addSearchCondition 方法是一个强大且灵活的工具，不仅可以实现标准的 LIKE 查询，通过巧妙地利用其第五个参数 $likeOperator，我们也能轻松地构建 NOT LIKE 查询。这为在 Yii 1.1 应用中处理反向模式匹配需求提供了简洁而高效的解决方案。理解并善用这些参数，能够帮助开发者更精确地控制数据库查询逻辑，提升应用程序的数据处理能力。