CakePHP中如何合并BelongsTo与HasMany关联的跨表筛选逻辑

你之前分开写的两套筛选逻辑默认是AND关系，会要求搜索词同时命中两类关联的字段，不符合“匹配任意一类即可”的需求，可通过以下两种方案实现： #

方案1：leftJoinWith + 条件分组（推荐） #

通过左连接加载HasMany关联，将两类筛选条件放到同一OR条件组中，逻辑最直观：

if (!empty($search)) {
    $words = explode(' ', trim($search));
    // 左连接加载HasMany关联，保留所有主表记录
    $query->leftJoinWith('IssueComments');
    $primaryKey = $this->getModel()->getPrimaryKey();

    foreach ($words as $word) {
        $orConditions = [];
        // 添加主表/BelongsTo关联字段的匹配条件
        foreach ($this->searchFields as $searchField) {
            $orConditions[] = [$searchField . ' LIKE' => "%{$word}%"];
        }
        // 添加HasMany关联字段的匹配条件
        $orConditions[] = ['IssueComments.comment LIKE' => "%{$word}%"];
        
        // 多词默认按AND逻辑拼接，如需任意词匹配可调整为外层统一OR
        $query->where(['OR' => $orConditions]);
    }
    
    // 去重，避免HasMany多条匹配导致主表记录重复
    $query->distinct($primaryKey);
}

方案2：子查询exists实现 #

如果不想用左连接，也可以通过exists子查询封装HasMany的匹配逻辑，和主表条件做OR拼接：

if (!empty($search)) {
    $words = explode(' ', trim($search));
    $alias = $this->getModel()->getAlias();

    foreach ($words as $word) {
        $query->where(function ($exp) use ($word, $alias) {
            // 构造主表/BelongsTo的匹配条件
            $mainConds = [];
            foreach ($this->searchFields as $searchField) {
                $mainConds[] = [$searchField . ' LIKE' => "%{$word}%"];
            }
            $mainExp = $exp->or($mainConds);

            // 构造HasMany匹配的exists子查询
            $hasManyCond = $exp->exists(
                $this->getModel()->getAssociation('IssueComments')
                    ->find()
                    ->select(['1'])
                    ->where(function ($qExp) use ($alias, $word) {
                        return $qExp->equalToFields('IssueComments.foreign_key', $alias . '.id') // 替换为实际外键字段
                                    ->like('IssueComments.comment', "%{$word}%");
                    })
            );

            return $exp->or([$mainExp, $hasManyCond]);
        });
    }
}

适配说明 #

如果你的搜索需求是多词任意匹配，只需要把所有词的条件都放到同一个外层OR组即可，不需要循环对每个词单独加where。

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