0

0

如何将 PHP 处理后的 JSON 保持原始换行与缩进风格(每对象一行)

霞舞

霞舞

发布时间:2026-01-14 23:13:04

|

196人浏览过

|

来源于php中文网

原创

如何将 PHP 处理后的 JSON 保持原始换行与缩进风格(每对象一行)

本文介绍一种在 php 中手动构造“类原始风格”json 字符串的方法,使其维持 `[` 开头、每个对象独占一行、末尾带 `]` 的可读格式,而非默认的单行紧凑输出。适用于调试或特定格式兼容场景,但不推荐用于生产环境。

在 PHP 中,json_encode() 默认生成紧凑、无换行、无空格的 JSON 字符串(如 [{"id":"1","name":"john"},...]),这虽利于传输与解析,却不便于人工阅读或版本控制比对。而用户原始 JSON 文件采用的是“类手工排版”风格:数组整体换行包裹,每个对象独立成行、字段间保留空格(如 "id": "1" 而非 "id":"1")。这种格式虽非标准 JSON 规范所强制要求,但在某些编辑场景(如 Git diff 友好、配置文件维护)中确有实用价值。

要实现该效果,不能依赖 json_encode() 的内置选项(如 JSON_PRETTY_PRINT 会产生缩进嵌套,不符合“每对象一行”的扁平结构),而需手动拼接:

  1. 确保输入为索引数组(list):使用 array_is_list()(PHP ≥8.1)或自定义 polyfill 判断,避免关联数组导致逻辑错误;
  2. 逐项 json_encode() 每个元素:利用其默认紧凑格式保证单个对象内无额外换行;
  3. 用 implode(",\n", ...) 连接对象:实现逗号+换行分隔;
  4. 手动包裹 [ 和 ] 并添加首尾换行:达成目标结构。

以下是完整、可直接运行的示例代码:

// PHP < 8.1 兼容 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 formatJsonAsOneLinePerItem(array $data): string {
    if (!array_is_list($data)) {
        throw new InvalidArgumentException('Input must be a sequential array (list).');
    }

    $encodedItems = array_map(fn($item) => json_encode($item), $data);
    return "[\n" . implode(",\n", $encodedItems) . "\n]";
}

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

// 修改数据(如更新姓名)
$decoded[1]['name'] = 'bill';

// 重新格式化为原始风格
$result = formatJsonAsOneLinePerItem($decoded);
echo $result;

输出结果严格匹配需求:

百度智能云·曦灵
百度智能云·曦灵

百度旗下的AI数字人平台

下载

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

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

⚠️ 重要注意事项

  • 此方法生成的 JSON 完全合法(符合 RFC 8259),空格与换行在 JSON 中是允许的空白字符,不影响解析;
  • 但它牺牲了可维护性与健壮性:一旦数据结构嵌套加深(如 bd 内含对象),手动拼接将迅速失控;
  • 强烈建议替代方案
    • 生产环境始终使用 json_encode($data, JSON_UNESCAPED_UNICODE) 等标准方式;
    • 查看/编辑时借助命令行工具(如 jq -C '.' input.json | less)或编辑器插件实时美化;
    • 版本控制中可配置 .gitattributes 对 .json 文件启用 diff=json,提升可读性。

总之,该技巧是特定场景下的“权宜之计”,理解其原理有助于规避误用,而拥抱标准工具链才是长期高效之道。

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2516

2023.09.01

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

1598

2023.10.11

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

1493

2023.10.11

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

952

2023.10.23

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

1416

2023.10.23

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

1234

2023.11.03

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1445

2023.11.09

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

1306

2023.11.13

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
PHP课程
PHP课程

共137课时 | 8.6万人学习

JavaScript ES5基础线上课程教学
JavaScript ES5基础线上课程教学

共6课时 | 7万人学习

PHP新手语法线上课程教学
PHP新手语法线上课程教学

共13课时 | 0.9万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号