如何让CakePHP QueryBuilder为子查询添加双层括号？

问题场景：
数据库某表存在存储ID列表的JSON类型字段，使用CakePHP 3.8.1的QueryBuilder构建查询时，单层括号包裹子查询的SQL会触发语法错误：

-- 报错SQL
SELECT a.id, a.name FROM car AS a
WHERE a.id MEMBER OF (SELECT b.value FROM other_table AS b WHERE b.key = 'fancy_cars');

只有双层括号包裹的SQL才能正常执行：

-- 正常执行的SQL
SELECT a.id, a.name FROM car AS a
WHERE a.id MEMBER OF ((SELECT b.value FROM other_table AS b WHERE b.key = 'fancy_cars'));

当前使用的QueryBuilder代码无法生成双层括号，且尝试嵌套子查询、数组包裹子查询这两种方法均无效。

可行解决方案 #

通过手动构建查询表达式，强制为子查询添加额外一层括号，以下是两种可靠方式：

方式一：使用QueryExpression直接拼接条件

利用QueryExpression的add方法，手动写出带双层括号的条件语句，CakePHP会自动处理子查询的参数绑定：

$sub = new \Cake\Database\Query();
$sub
  ->select('b.value')
  ->from(['b' => 'other_table'])
  ->where(['b.key' => 'fancy_cars']);

$query = new \Cake\Database\Query();
$query
  ->select(['a.id', 'a.name'])
  ->from(['a' => 'car'])
  ->where(function (\Cake\Database\Expression\QueryExpression $exp) use ($sub) {
      return $exp->add("a.id MEMBER OF (($sub))");
  });

方式二：用LiteralExpression包裹子查询

先将子查询用LiteralExpression包裹一层括号，再传入MEMBER OF条件中，最终生成的SQL会带有双层括号：

$sub = new \Cake\Database\Query();
$sub
  ->select('b.value')
  ->from(['b' => 'other_table'])
  ->where(['b.key' => 'fancy_cars']);

// 为子查询额外包裹一层括号
$wrappedSub = new \Cake\Database\Expression\LiteralExpression("($sub)");

$query = new \Cake\Database\Query();
$query
  ->select(['a.id', 'a.name'])
  ->from(['a' => 'car'])
  ->where(['a.id MEMBER OF' => $wrappedSub]);

为什么之前的方法无效 #

• 嵌套子查询：CakePHP会将内层子查询解析为字段选择逻辑，生成的SQL结构不符合MEMBER OF的要求，无法形成双层括号。
• 数组包裹子查询：QueryBuilder会将数组识别为IN条件的参数集合，而非额外的括号包裹，因此达不到预期效果。

内容的提问来源于stack exchange，提问作者WoodrowShigeru