本文讲解如何将 pdo 查询返回的多维数组逐条处理（如坐标转地址），避免因变量覆盖导致仅返回单条数据的问题，并生成结构清晰、可直接用于前端展示的新数组。

在使用 PDO::FETCH_NAMED 获取数据库结果时，fetchAll() 返回的是一个包含多条记录的数组（即 array[0], array[1], ...）。你原始代码中定义了 $result = [...] 并在循环内反复赋值（如 $result['nameA'] = ...），这会导致每次迭代都覆盖同一变量，最终只保留最后一次循环的结果——因此 JSON 输出只剩一条记录。

✅ 正确做法是：为每条记录创建独立子数组，并将其追加到 $result 中（即 $result[] = [...]），使 $result 成为一个二维索引数组，与原始 fetchAll() 的结构一致。

以下是推荐的完整实现：

$matches = $stmt->fetchAll(PDO::FETCH_NAMED);
$result = []; // 显式初始化为空数组，提高可读性与健壮性

foreach ($matches as $match) {
    // 安全提取 name 数组（防键缺失或长度不足）
    $names = $match['name'] ?? [];
    $nameA = $names[0] ?? '';
    $nameB = $names[1] ?? '';
    $nameC = $names[2] ?? '';

    // 调用反向地理编码（建议增加异常处理与缓存逻辑）
    $location = $this->reverse_geocode(
        trim($match['coordinate x'] ?? '0'),
        trim($match['coordinate y'] ?? '0')
    ) ?: 'Unknown location';

    $result[] = [
        'nameA'      => trim($nameA),
        'nameB'      => trim($nameB),
        'nameC'      => trim($nameC),
        'date'       => $match['date'] ?? null,
        'round'      => $match['round'] ?? null,
        'leauge_id'  => $match['leauge_id'] ?? null,
        'location'   => $location,
    ];
}

return $result; // 返回形如 [ {...}, {...}, ... ] 的标准 JSON 数组

? 关键注意事项：

• ✅ 使用 $result[] = [...] 实现追加而非覆盖，确保返回多条记录；
• ✅ 对 name 数组和坐标字段做空值/越界防护（?? 和 [] ??），避免 Notice: Undefined index；
• ✅ trim() 去除名称前后的空格（如 " name1" → "name1"），提升数据质量；
• ⚠️ reverse_geocode() 是外部调用，建议：
  • 添加超时与重试机制；
  • 对相同坐标做内存或 Redis 缓存，避免重复请求 Google API；
  • 捕获异常并提供降级值（如 'Unknown location'），防止单条失败中断整个响应；
• ? 最终返回的 $result 可直接 json_encode() 发送给前端，结构与你期望的 JSON 数组完全一致，前端可用 fetch().then(data => data.forEach(...)) 安全遍历。

通过以上重构，你将获得一个结构统一、健壮可靠、易于前端消费的多记录数据集。