升级CakePHP至3.x后，SQL查询结果无法按表分组的解决需求

针对CakePHP 3.x使用PDO驱动后，原生SQL查询结果无法按表别名分组且字段被覆盖的问题，提供以下三种可行方案：

方法1：修改SQL字段别名，手动重组结果 #

通过给字段添加表别名前缀（用双下划线分隔），再遍历结果将数据按表名分组，彻底解决字段覆盖问题。

// 修改后的SQL，给每个字段添加表别名前缀
$sql = "SELECT pm.id AS pm__id, pmp.id AS pmp__id  
        FROM product_models as pm  
        LEFT JOIN product_model_prices as pmp  
            ON pmp.item = pm.item  
        LIMIT 1";

// 执行原生查询
$result = ConnectionManager::get('default')->execute($sql)->fetchAll('assoc');

// 重组结果为CakePHP 1.3格式
$formattedResult = [];
foreach ($result as $row) {
    $groupedRow = [];
    foreach ($row as $key => $value) {
        list($tableAlias, $field) = explode('__', $key);
        if (!isset($groupedRow[$tableAlias])) {
            $groupedRow[$tableAlias] = [];
        }
        $groupedRow[$tableAlias][$field] = $value;
    }
    $formattedResult[] = $groupedRow;
}

最终$formattedResult的结构将完全匹配CakePHP 1.3的返回格式。

方法2：使用CakePHP QueryBuilder构建查询（推荐） #

利用CakePHP内置的查询构造器代替原生SQL，框架会自动按表别名分组结果，无需手动处理字段和分组逻辑。

use Cake\Datasource\ConnectionManager;

$connection = ConnectionManager::get('default');
// 用QueryBuilder构建查询
$query = $connection->newQuery()
    ->select([
        'pm.id',
        'pmp.id'
    ])
    ->from(['pm' => 'product_models'])
    ->leftJoin(['pmp' => 'product_model_prices'], 'pmp.item = pm.item')
    ->limit(1);

// 获取结果，格式与CakePHP 1.3完全一致
$result = $query->execute()->fetchAll('assoc');

此方法不仅自动生成分组结构，还能避免字段名冲突，同时保留CakePHP的ORM特性。

方法3：通过PDO列元数据自动分组（无需修改SQL） #

借助PDO的getColumnMeta()方法获取字段所属的表别名，自动重组结果集。注意：该方法依赖数据库驱动对元数据的支持，不同数据库可能存在兼容性差异。

$connection = ConnectionManager::get('default');
$statement = $connection->execute($sql);

// 获取所有字段的元数据（表别名、字段名）
$columnMeta = [];
for ($i = 0; $i < $statement->columnCount(); $i++) {
    $meta = $statement->getColumnMeta($i);
    // MySQL驱动下，table字段返回的是表别名
    $tableAlias = $meta['table'];
    $fieldName = $meta['name'];
    $columnMeta[$i] = ['table' => $tableAlias, 'field' => $fieldName];
}

// 遍历结果并按表别名分组
$formattedResult = [];
while ($row = $statement->fetch(PDO::FETCH_NUM)) {
    $groupedRow = [];
    foreach ($row as $index => $value) {
        $table = $columnMeta[$index]['table'];
        $field = $columnMeta[$index]['field'];
        if (!isset($groupedRow[$table])) {
            $groupedRow[$table] = [];
        }
        $groupedRow[$table][$field] = $value;
    }
    $formattedResult[] = $groupedRow;
}

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