在 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 方法的各个参数：
- $column (string): 必需。指定要应用搜索条件的数据库列名。
- $value (mixed): 必需。指定要搜索的值。
-
$partialMatch (boolean): 可选，默认为 false。
- 如果设置为 true，则 $value 会被自动包裹在百分号 % 中（例如，%value%），实现模糊匹配。
- 如果设置为 false，则 $value 会被精确匹配，即 LIKE 'value' 或 NOT LIKE 'value'。
-
$operator (string): 可选，默认为 'AND'。
- 指定当前条件与前一个条件之间的逻辑操作符，可以是 'AND' 或 'OR'。
-
$likeOperator (string): 可选，默认为 'LIKE'。
- 这是实现 NOT LIKE 的核心参数。 通过将其设置为 'NOT LIKE'，可以将模糊匹配操作符从 LIKE 切换为 NOT LIKE。你也可以在这里指定其他数据库支持的模糊匹配操作符，例如 ILIKE（通常用于 PostgreSQL 的不区分大小写匹配）。
注意事项
- Yii 版本兼容性: 本文的解决方案适用于 Yii 1.1 版本。在 Yii 2.x 中，yii\db\Query 和 yii\db\ActiveQuery 提供了不同的查询构建方式，例如使用 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 应用中处理反向模式匹配需求提供了简洁而高效的解决方案。理解并善用这些参数，能够帮助开发者更精确地控制数据库查询逻辑，提升应用程序的数据处理能力。
