PHP PDO 中遍历关联数组的正确方法

本文详解如何正确遍历 pdo::fetch_assoc 返回的二维关联数组，避免“array to string conversion”错误，并提供清晰、安全、可复用的迭代方案。

先说一个常见的场景：你用 PDO::FETCH_ASSOC 从数据库里取了一堆配置项，比如站点标题、session 启动时间之类的。结果一循环，直接报了个“Array to string conversion”的警告——问题出在哪？其实很简单，fetchAll(PDO::FETCH_ASSOC) 返回的是一个索引数组，每个元素又是一个关联数组，典型的二维结构。这就好比你拿到的是一摞卡片，每张卡片上又写着键值对，不能直接用字符串拼接去处理。

举个例子，数据长这样：

$stmt = $pdo->query("SELECT setting, setting_value FROM app_config")->fetchAll(PDO::FETCH_ASSOC);
// 结果是 [ ['setting'=>'site_title', 'setting_value'=>'My Website'], ... ]

如果你直接写：

foreach ($stmt as $key => $value) {
    echo "
$key = $value
"; // ❌ 这里会报错
}

PHP 会尝试把 $value（一个数组）转成字符串，自然就触发了警告。问题的根源就在这里。

✅ 正确的做法是两层遍历：外层遍历每一行记录，内层再遍历该行的键值对。这样既清晰又保险：

 'site_title', 'setting_value' => 'My Website']
    foreach ($record as $key => $value) {
        echo "
{$key}: " . htmlspecialchars($value) . "
";
    }
}

? 推荐优化：转成扁平化的配置映射
大部分情况下，你真正需要的是把 setting 字段当键、setting_value 当值，构建一个一维数组，方便通过 $config['site_title'] 直接取用。实现起来也不复杂：

$config = [];
foreach ($stmt as $row) {
    if (isset($row['setting'], $row['setting_value'])) {
        $config[$row['setting']] = $row['setting_value'];
    }
}
// 用的时候直接引用键名
echo $config['site_title'];      // 输出：My Website
echo $config['session_start'];   // 输出：01-April-2022

⚠️ 有几个细节值得注意：

• 输出到 HTML 的内容，记得用 htmlspecialchars() 转义，这是防止 XSS 的基本功；
• 访问数组元素前，先检查键是否存在（比如 isset($row['setting'])），可以避免未定义索引的警告；
• 如果配置项数量多、逻辑复杂，可以考虑封装成函数或服务类，方便后续维护；
• 循环内部尽量避免再执行数据库查询或耗时操作，保持逻辑简洁。

理解了 fetchAll(PDO::FETCH_ASSOC) 返回的是二维结构之后，采用分层遍历或者扁平化映射的方式，就能彻底绕开类型转换的坑。代码写出来更健壮，读起来也一目了然。