Craft CMS 5.x 中布尔值查询条件的特殊处理方式

在Craft CMS 5.x版本中，开发者在使用自定义查询时可能会遇到一个关于布尔值处理的特殊现象。本文将详细解析这个问题及其解决方案。

问题现象

当开发者使用andWhere()或where()方法构建复杂查询时，如果查询条件中包含布尔值，可能会出现预期之外的行为。具体表现为：

// 这个查询无法正常工作
$query->andWhere([
    'or',
    ['<>', 'fieldServer', 'other'],
    ['and', ['fieldServer' => 'other'], ['fieldSyncOther' => true]]
]);

// 而这个使用字符串'true'的查询却能正常工作
$query->andWhere([
    'or',
    ['<>', 'fieldServer', 'other'],
    ['and', ['fieldServer' => 'other'], ['fieldSyncOther' => 'true']]
]);

技术解析

这个现象的根本原因在于Craft CMS内部对JSON数据的处理机制：

1. JSON数据存储：Craft CMS将字段值以JSON格式存储在数据库中
2. 字段值提取：系统使用JSON_EXTRACT表达式来规范化字段处理
3. 布尔值转换：在JSON上下文中，布尔值true和字符串'true'的处理方式不同

解决方案

针对这个问题，开发者可以采取以下解决方案：

1. 使用字符串形式：如示例所示，将布尔值true改为字符串'true'
2. 使用整数形式：也可以尝试使用1代替true
3. 直接字段查询：对于简单查询，使用fieldSyncOther(true)语法可以正常工作

最佳实践建议

1. 在构建复杂查询时，建议先检查生成的SQL语句
2. 对于布尔值字段的查询，优先考虑使用字符串形式
3. 在开发过程中，可以使用Craft的调试工具检查查询构建过程

系统版本影响

这个问题在Craft CMS 5.6.13版本中被确认存在，但可能影响更广泛的5.x版本。开发者在使用高级查询功能时应当注意这个特性。

理解这个特性有助于开发者更高效地构建复杂的数据库查询，避免在开发过程中浪费时间去排查看似简单的查询问题。