如何使用 FirebaseLib 正确遍历嵌套的 JSON 数据节点

本文详解如何在 php 中安全解析并枚举 firebaselib 返回的嵌套数据（如 `/names/` 下的多节点结构），涵盖 `json_decode()` 的正确用法、错误排查技巧及调试输出的最佳实践。

FirebaseLib 的 get() 方法返回的是原始响应字符串（通常为 JSON 格式），不能直接当作数组遍历——必须先正确解码，且需严格处理可能的解析失败与数据类型问题。

✅ 正确做法：带错误检查的 JSON 解析与遍历

$response = $firebase->get(PATH . '/' . $users . '/names/');
if ($response === false) {
    die('Firebase request failed.');
}

// 显式指定关联数组（true），避免对象访问语法混淆
$online_users = json_decode($response, true);

// 检查 JSON 解析是否成功
if (json_last_error() !== JSON_ERROR_NONE) {
    error_log('JSON decode error: ' . json_last_error_msg() . ' | Raw response: ' . $response);
    die('Invalid JSON received from Firebase.');
}

// 调试：使用 print_r 或 var_dump 查看结构（echo 不适用于数组/对象）
// print_r($online_users); // 推荐用于开发阶段

// 安全遍历：确保 $online_users 是非空数组
if (is_array($online_users) && !empty($online_users)) {
    foreach ($online_users as $key => $value) {
        // 注意：$value 可能是字符串、数字、布尔值，甚至嵌套数组（如 { "name": "Alice", "status": "online" }）
        if (is_scalar($value)) {
            echo htmlspecialchars($key) . ': ' . htmlspecialchars((string)$value) . '
';
        } elseif (is_array($value)) {
            // 若 value 本身是对象（如用户详情），可进一步提取字段
            $name = $value['name'] ?? 'N/A';
            $status = $value['status'] ?? 'unknown';
            echo htmlspecialchars($key) . ": {$name} ({$status})
";
        }
    }
} else {
    echo 'No online users found or data is empty.
';
}

⚠️ 关键注意事项

• echo $online_users 会报错或输出 Array 字符串：因为 json_decode() 默认返回对象，加 true 参数才返回关联数组；而数组/对象不可直接 echo，应使用 print_r()、var_dump() 或 json_encode() 辅助调试。
• 始终校验 json_last_error()：网络波动、权限不足或 Firebase 节点为空（返回 null 或空字符串）都会导致 json_decode() 返回 null，不检查则后续 foreach 会触发 Warning: Invalid argument supplied for foreach()。
• 路径末尾斜杠影响行为：Firebase REST API 对 /names/（带斜杠）与 /names（不带）可能返回不同结构（前者强制返回对象映射，后者可能返回单值），建议统一使用无尾斜杠路径，或在代码中明确预期结构。
• XSS 防护：输出到 HTML 前务必对 $key 和 $value 使用 htmlspecialchars()，尤其当数据来自外部（如 Firebase）时。

掌握这些要点后，你就能稳健地处理 Firebase 中任意深度的嵌套数据节点，无论是扁平化用户名列表，还是包含 avatar、lastSeen 等字段的复杂用户对象结构。