PHP写入多组数组到JSON文件后json_decode返回null问题解决

标准JSON规范仅允许文件内存在1个顶级根元素。当前写入逻辑使用FILE_APPEND追加模式，每次写入直接将新编码的JSON数组拼接在文件末尾，最终文件会出现多个平级的数组根元素，属于非法JSON格式，因此json_decode解析到第二组根元素时会直接返回NULL。

不要直接追加编码后的JSON字符串。每次写入前先读取文件内已存储的全量数据，将新数据追加到统一的顶级数据结构中，再重新编码后覆盖写入文件，保证文件始终只有一个合法的顶级根元素。

调整后的读写方法实现 #

public function JSONwrite($lists)
{
    // 初始化已有数据为空数组
    $existingData = [];
    // 如果存储文件已存在，先读取解析已有内容
    if (file_exists("/var/www/html/3sprint/test.json")) {
        $rawContent = file_get_contents("/var/www/html/3sprint/test.json");
        $existingData = json_decode($rawContent, true) ?: [];
    }
    // 将本次传入的新数据追加到全量数据结构中
    $existingData[] = $lists;
    // 重新编码全量数据，覆盖写入文件，不再使用FILE_APPEND追加模式
    file_put_contents(
        "/var/www/html/3sprint/test.json",
        json_encode($existingData, JSON_UNESCAPED_UNICODE)
    );
}

public function JSONread()
{
    $string = file_get_contents("/var/www/html/3sprint/test.json");
    $stringContent = json_decode($string, true);
    var_dump($stringContent);
}

你之前传入JSONwrite方法的数组填充逻辑不需要做任何修改，直接替换读写方法即可。

调整后合法JSON格式示例 #

修改后文件内仅存在一个顶级数组，所有历史提交的数据都作为这个顶级数组的子元素，完全符合JSON语法规范：

[
    [{"count":"3","name":"testnameone"},{"count":"5","name":"testnametwo"},{"count":"6","name":"testnamethree"},{"info":106}],
    [{"count":"3","name":"testnamefour"},{"count":"5","name":"testnamefive"},{"count":"6","name":"testnamesix"},{"info":521}]
]

大数据量场景可选方案 #

如果需要存储的数据量特别大，每次全量读写会产生明显性能开销，可以改用JSON Lines格式：每行存储一个独立合法的JSON片段，读取时按换行符拆分内容逐行解析。但常规中小数据量场景下，使用单根元素的标准JSON文件兼容性最好，实现逻辑也最简洁。

内容的提问来源于stack exchange，提问作者Duno