CakePHP ORM带hasMany关联的多contain条件过滤查询实现

原逻辑的三个核心偏差导致预期结果无法达成：

• 手动在主查询层INNER JOIN transactions表时未做结果去重，单用户匹配多条交易时会生成重复的country_of_residence_history记录
• 过滤条件直接绑定在主查询的JOIN关联上，和ORM的关联加载逻辑割裂，既无法实现"只要用户存在至少一条符合条件的交易就保留记录"的存在性校验，还会在匹配不到交易时直接清空主查询结果，和预期逻辑不符
• 混合手动JOIN和ORM的关联映射逻辑，容易出现字段错位、实体属性不匹配的问题

针对这类"基于hasMany关联的存在性过滤、同时加载全量关联数据"的场景，CakePHP ORM专门提供matching()方法，完全适配需求：

• 该方法会自动生成独立子查询做存在性校验，不会在主查询层生成JOIN导致的重复行
• 关联数据的加载完全和过滤逻辑解耦，依然通过contain实现二次批量查询，不受hasMany关联的查询机制限制

// 提取交易过滤条件
$transactionConditions = [
    'Transactions.unit_id' => $this->request->getData('unit_id'),
    'Transactions.status' => 'confirmed'
];

$query = $this->CorHistory->find('all')
    // 存在性过滤：只要用户关联的交易存在至少一条符合条件的记录，就保留当前CorHistory条目
    ->matching('Users.Transactions', function ($query) use ($transactionConditions) {
        return $query->where($transactionConditions);
    })
    // 独立配置关联加载规则，和过滤逻辑完全解耦
    ->contain([
        'Users' => [
            // 按需求返回用户指定字段
            'fields' => ['id', 'first_name', 'last_name'],
            // 加载用户关联的全量交易，按需求指定返回字段
            'Transactions' => [
                'fields' => ['id', 'user_id', 'unit_id', 'status']
            ]
        ]
    ])
    // 显式指定CorHistory需要返回的字段，避免冗余
    ->select([
        'id', 'user_id', 'cor_before', 'cor_after', 'created'
    ])
    // 对主记录去重，避免潜在的重复行
    ->distinct(['CorHistory.id'])
    // 清理matching自动生成的冗余匹配数据，对齐目标返回结构
    ->formatResults(function ($results) {
        return $results->map(function ($entity) {
            unset($entity->_matchingData);
            return $entity;
        });
    });

如果不需要返回用户的全量交易，仅需要返回符合unit_id、status条件的交易，只需要在contain的Transactions配置里添加对应where条件即可——因为这部分逻辑属于二次批量查询，完全不会影响主查询的存在性过滤结果。

最终返回的实体结构将和你给出的示例完全匹配：包含CorHistory的指定字段、关联的User实体、User实体下嵌套的Transactions列表，且当传入不存在的unit_id时会正确返回空结果集，不会出现异常。

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