如何在 PHP 中将 JSON 数组保持多行格式(每对象一行)重新序列化

如何在 PHP 中将 JSON 数组保持多行格式(每对象一行)重新序列化

本文介绍一种非标准但实用的 php 方法,用于将解码后再修改的 json 数组以“换行分隔、括号独占行”的类原始风格重新编码为字符串,避免默认 `json_encode()` 生成的单行紧凑格式。

在处理 JSON 文件时,开发者常希望保留可读性良好的多行格式(如每条 JSON 对象独占一行、方括号独立成行),尤其在人工编辑或版本控制场景中。然而,PHP 原生 json_encode() 默认输出紧凑单行格式(如 [{“id”:”1″,”name”:”john”},…]),即使传入 JSON_PRETTY_PRINT 也仅提供缩进式美化,无法实现「每对象一行 + 外层括号独立」的特定排版。

要达成目标格式:

[
{"id": "1", "name": "john", "bd": []},
{"id": "2", "name": "gary", "bd": [1, 2]}
]

关键在于:不依赖 json_encode() 的整体格式化能力,而是手动拼接外层结构,对每个数组元素单独调用 json_encode() 并换行连接

以下是一个健壮的实现方案(兼容 PHP

立即学习PHP免费学习笔记(深入)”;

先见AI

先见AI

数据为基,先见未见

下载

// PHP <8.1 兼容 array_is_list() polyfill
if (!function_exists('array_is_list')) {
    function array_is_list(array $a): bool {
        return $a === [] || (array_keys($a) === range(0, count($a) - 1));
    }
}

function json_encode_oneline_per_item(array $data): string {
    if (!array_is_list($data)) {
        throw new InvalidArgumentException('Input must be a JSON array (sequential list), not an associative object.');
    }

    // 对每个元素单独编码(无额外空格,保证内部紧凑)
    $encodedItems = array_map(fn($item) => json_encode($item, JSON_UNESCAPED_UNICODE), $data);

    // 拼接:换行分隔,前后包裹换行后的方括号
    return "[/n" . implode(",/n", $encodedItems) . "/n]";
}

// 示例使用
$json_text = '
[
{"id": "1", "name": "john", "bd": []},
{"id": "2", "name": "gary", "bd": [1, 2]}
]';

$data = json_decode($json_text, true);
$data[1]['name'] = 'bill'; // 修改数据

$result = json_encode_oneline_per_item($data);
echo $result;

输出结果严格匹配预期:

[
{"id":"1","name":"john","bd":[]},
{"id":"2","name":"bill","bd":[1,2]}
]

⚠️ 重要注意事项

  • 此方法生成的 JSON 语法完全合法,但属于「人为定制格式」,不应替代标准 JSON 工具链;
  • json_encode() 默认已处理 Unicode、引号转义、特殊字符等安全问题,本方案复用它保障内容安全性;
  • 若需支持嵌套数组/对象的深度美化(如 bd 内部也换行),需递归实现 —— 但会显著增加复杂度,强烈建议此时改用 jq 或 VS Code 插件等专业工具进行后处理
  • 生产环境应始终以标准 json_encode($data, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT) 作为默认输出;仅在明确需要 Git 友好 diff 或人工可读日志时,才按需启用此类定制格式。

总之,格式是表象,语义与安全才是核心。让 PHP 负责正确性,让专业工具负责可读性——这是更可持续的实践路径。

https://www.php.cn/faq/1983952.html

发表回复

Your email address will not be published. Required fields are marked *