如何在 PHP 中正确处理并转换数据库查询的多条记录为结构化数组

本文介绍如何使用 php 将 pdo 查询返回的多维结果集逐条处理（如坐标转地址），避免因变量复用导致数据覆盖，并生成符合前端需求的结构化数组。

在 PHP 后端开发中，当从数据库获取多条记录（例如通过 PDO::FETCH_NAMED）并需对每条记录进行额外处理（如调用反向地理编码 API 将经纬度转换为地点名称）时，一个常见错误是未正确初始化或追加结果数组，导致最终只返回最后一条处理后的数据。

你当前的问题核心在于：

$result['nameA'] = ...; // ❌ 每次循环都覆写 $result 关联数组

这使得 $result 始终只保留最后一次迭代的值，最终仅输出单条记录。

✅ 正确做法是将每条处理后的记录追加为新元素到一个索引数组中：

$matches = $stmt->fetchAll(PDO::FETCH_NAMED);
$result = []; // 显式初始化空数组（推荐，增强可读性与健壮性）

foreach ($matches as $match) {
    // 确保 name 数组至少有 3 个元素，避免 Notice 错误
    $names = $match['name'] ?? ['', '', ''];

    $result[] = [
        'nameA' => trim($names[0] ?? ''),
        'nameB' => trim($names[1] ?? ''),
        'nameC' => trim($names[2] ?? ''),
        'date' => $match['date'] ?? null,
        'round' => $match['round'] ?? null,
        'leauge_id' => $match['leauge_id'] ?? null,
        'location' => $this->reverse_geocode(
            (float)($match['coordinate x'] ?? 0),
            (float)($match['coordinate y'] ?? 0)
        ),
    ];
}

return $result;

? 关键要点说明：

• 使用 $result[] = [...] 语法实现自动索引追加，确保每条记录独立存在；
• 对源字段（如 name、坐标）添加空值判断和默认值（??），防止 Undefined index 错误；
• 使用 trim() 清理原始数据中可能存在的首尾空格（如 " name1" → "name1"）；
• 显式类型转换（如 (float)）提升 reverse_geocode() 接口调用的稳定性；
• 若 reverse_geocode() 是耗时操作（如 HTTP 请求），建议考虑异步批量处理或缓存机制以优化性能（生产环境强烈推荐）。

最终返回的 JSON 将是标准的数组格式，与前端 fetch() 预期完全兼容：

[
  {
    "nameA": "name1",
    "nameB": "name2",
    "nameC": "name3",
    "date": "2025-02-05 12:00:00",
    "round": "3",
    "leauge_id": 4,
    "location": "Berlin, Germany"
  },
  { ... }
]

这样既保持了数据完整性，又满足了前端展示“多条带位置信息记录”的业务需求。