在 PHP 里处理 JSON，稳妥的做法是先用数组把数据组织好，再统一编码，尽量别直接拼字符串。

需要合并时，优先用array_replace_recursive()，这样能避免嵌套层级里的内容被覆盖丢失。

涉及动态注入，适合用sprintf或unset来处理。如果数据来自多个来源，最好加上命名空间，减少键名冲突。

遇到中文内容，记得加JSON_UNESCAPED_UNICODE；而面对大整数，则要启用JSON_BIGINT_AS_STRING，避免精度悄悄丢掉。

PHP框架中拼接JSON数据，不是简单地把字符串用点号连接。

关键在于确保结构合法、类型准确、编码安全。 否则前端解析会失败，或出现数据丢失。

基础拼接：用数组组装再编码

处理 JSON 的基础方法，是先组装数组，再统一编码。

• 第一步：把所有要拼的数据先存进一个关联数组里，不要提前调用json_encode()单独编码某一部分。
• 第二步：用+或array_merge()合并多个数组时，注意键名冲突——数字键会被重排，字符串键会覆盖，【必须用array_replace_recursive()处理嵌套结构】，否则深层字段可能被意外丢弃。
• 第三步：统一调用json_encode()对整个数组编码，传入JSON_UNESCAPED_UNICODE和JSON_PRETTY_PRINT便于调试，上线前去掉JSON_PRETTY_PRINT。

动态字段注入：避免字符串拼接JSON

动态字段处理时，不建议直接拼接 JSON 字符串。

方法一：用空占位符+str_replace()

先定义模板：$template = '{"status":"%s","data":%s,"ts":%d}';

再填充：sprintf($template, 'success', json_encode($payload, JSON_UNESCAPED_UNICODE), time());

注意：$payload必须是能被json_encode()直接处理的数组或对象，不能是已编码的JSON字符串，否则会多一层引号。

方法二：构造中间数组后unset()冗余键

先完整构建数组，再用unset($arr['debug'])移除开发期字段，最后编码。

这种方式比条件拼接更可控，也更不容易出错。

多来源数据聚合：保持键名唯一性

多个来源的数据一起编码时，重点是避免键名冲突。

• 步骤一：为每个数据源加命名空间前缀，例如从数据库查出的用户数据用'user_'开头，缓存读取的配置用'cfg_'开头。
• 步骤二：检查各来源是否含同名键（如都叫'id'），如有冲突，强制重命名其中一个，【绝不能依赖array_merge()自动覆盖】，否则关键ID可能被静默替换。
• 步骤三：用json_encode()编码前，用is_array()和is_numeric()验证每个值的类型，防止int被转成string导致前端类型判断失效。

特殊字符与中文安全输出

默认json_encode()会把中文转成uXXXX格式，影响可读性。

加上JSON_UNESCAPED_UNICODE参数，即可保留原始汉字。

如果数据来自HTML表单或富文本编辑器，需先用htmlspecialchars_decode()清理实体编码，再json_encode()，否则"会变成u0022。

遇到null值要明确处理：json_encode(null)输出"null"字符串，但前端常期望字段消失，此时应unset()该键而非传null。

大整数防截断：服务端与前端一致

PHP默认把超长数字（如18位订单号）当成float处理，json_encode()后精度丢失。

启用JSON_BIGINT_AS_STRING标志可强制转为字符串。

示例：json_encode(['order_id' => '123456789012345678'], JSON_BIGINT_AS_STRING) → {"order_id":"123456789012345678"}

这一步不做，前端Ja vaScript拿到的就是四舍五入后的数值，无法还原原始ID。

《夸克》非常好用的免费AI浏览器

下载APP查看