PHP PDO::FETCH_GROUP怎样把查询结果按字段分组

在 PHP PDO 中，如果查询结果需要按某个字段整理成“分组键 => 多条记录”，可以直接使用 PDO::FETCH_GROUP。关键规则只有一个：分组字段必须放在 SELECT 结果的第一列，并把这个标志交给 fetchAll()，而不是交给逐行的 fetch()。

官方地址：https://www.php.net/

下面用部门和员工记录说明完整写法。示例使用 PHP 官方手册中定义的 Fetch Modes，代码中的数据仅用于演示。

先看清 FETCH_GROUP 的数组结构

假设一名员工只属于一个部门，但一个部门有多名员工。查询时把 department 放在第一列，随后选择需要保留的明细列：

query($sql);
// FETCH_GROUP 只能用于 fetchAll；FETCH_ASSOC 保留列名。
$grouped = $stmt->fetchAll(PDO::FETCH_GROUP | PDO::FETCH_ASSOC);

print_r($grouped);
?>

如果结果中有 engineering 和 design 两个部门，$grouped 的形状大致是：

Array
(
    [engineering] => Array
        (
            [0] => Array ( [user_id] => 101 [user_name] => Lin )
            [1] => Array ( [user_id] => 104 [user_name] => Chen )
        )
    [design] => Array
        (
            [0] => Array ( [user_id] => 108 [user_name] => Wu )
        )
)

这里外层键来自第一列，外层每个值都是一个数组；内层数组才是每条记录。若把 user_id 放到第一列，分组结果就会按员工编号组织，而不是按部门组织。

用 ORDER BY 控制每组内部顺序

FETCH_GROUP 负责整理数组，不负责重新排序。数据库返回的行顺序会影响每个分组内部的下标，因此需要把顺序写在 SQL 中。上面的 ORDER BY department, user_id 表示先按部门排列，再让每个部门里的员工按编号升序排列。

如果业务要求按入职时间展示，可以改成 ORDER BY department, joined_at DESC。不要在 PHP 中先分组、再对每组重复排序，这会把本来可以交给数据库完成的工作搬到应用层。

query($sql);
// 每个部门的内层下标保持 SQL 返回顺序。
$grouped = $stmt->fetchAll(PDO::FETCH_GROUP | PDO::FETCH_ASSOC);
?>

同一个分组字段为 NULL 时，也会形成一个对应的键。若接口不允许出现空部门，应在 SQL 的 WHERE department IS NOT NULL 中明确过滤，或者在业务层把空键转换成约定的展示名称。

FETCH_GROUP 和 FETCH_UNIQUE 不要混用概念

PDO::FETCH_GROUP 保留同一键对应的多条记录，适合“一个部门有多名员工”的一对多结果。PDO::FETCH_UNIQUE 则把第一列作为唯一键，每个键只保留一条记录；当键重复时，后续记录会覆盖前面的值，所以它不适合承载一对多关系。

还要注意，两个标志都针对 fetchAll() 的多行结果；常见的组合是 PDO::FETCH_GROUP | PDO::FETCH_ASSOC、PDO::FETCH_GROUP | PDO::FETCH_COLUMN。如果只需要每组的一个字段，后者可以返回更轻量的二维数组。

query($sql);
// 第一列仍是分组键，第二列被收集为每组的字符串列表。
$namesByDepartment = $stmt->fetchAll(PDO::FETCH_GROUP | PDO::FETCH_COLUMN);
?>

把分组数组交给业务层

拿到分组数组后，业务层只需要两层遍历：第一层处理部门，第二层处理该部门的明细。这样比在模板里再次按部门扫描完整结果集更直接。

 $members) {
    // 空键可以按业务约定显示，避免页面出现难懂的空白标题。
    $departments[] = [
        'name' => $department === '' ? '未分配部门' : $department,
        'count' => count($members),
        'members' => $members,
    ];
}

foreach ($departments as $department) {
    // 这里可以交给模板渲染部门标题和成员列表。
    echo $department['name'] . ': ' . $department['count'] . PHP_EOL;
}
?>

常见问题

为什么分组没有生效？通常是把 FETCH_GROUP 传给了 fetch()，或分组列没有放在 SELECT 第一列。先确认调用的是 fetchAll()，再检查列顺序。

为什么每组只有一条记录？检查是否误用了 PDO::FETCH_UNIQUE，或者 SQL 本身已经通过 GROUP BY 把多行聚合成一行。PDO 的分组只改变 PHP 返回数组的形状，不会替你修改 SQL 结果。

数据量很大还能这样用吗？fetchAll() 会把剩余结果一次性放入内存。若结果规模不可控，应先限制查询范围、分页，或改用逐行读取后自行维护分组结构，并评估内存上限。

总结

• 把要分组的字段放在 SELECT 第一列。
• 使用 $stmt->fetchAll(PDO::FETCH_GROUP | PDO::FETCH_ASSOC) 保留一对多明细。
• 用 SQL 的 ORDER BY 决定每组内部顺序，并把 FETCH_UNIQUE 只用于确实唯一的键。

参考文档：https://www.php.net/manual/en/pdo.constants.fetch-modes.php；https://www.php.net/manual/en/pdostatement.fetchall.php