最稳方法是先json_decode为关联数组再array_merge或array_replace_recursive合并,最后json_encode;需处理null、bom、编码、重复键及性能优化。

PHP里用json_decode和json_encode合并JSON字符串最稳
直接拼接JSON字符串会破坏结构,必须先解析成PHP变量再合并。常见错误是把两个{"a":1}和{"b":2}用.连起来,结果得到非法JSON。
- 始终先用
json_decode($json, true)转成关联数组(第二个参数true不能漏,否则返回对象,后续合并麻烦) - 用
+操作符会丢键,改用array_merge()——它按顺序覆盖同名键,且保留数值索引 - 如果源JSON里有嵌套数组或对象,
array_merge_recursive()更安全,但注意它不会覆盖而是“堆叠”同名键
$a = json_decode('{"name":"Alice","tags":["php"]}', true);
$b = json_decode('{"age":30,"tags":["web"]}', true);
$result = array_merge($a, $b); // ["name"=>"Alice","age"=>30,"tags"=>["web"]]
echo json_encode($result); // {"name":"Alice","age":30,"tags":["web"]}
合并含重复键的JSON时,array_replace_recursive比array_merge更可控
当两个JSON都有"config"字段且都是数组,array_merge会直接替换整个子数组;而array_replace_recursive会逐层合并子键。
-
array_merge:遇到同名数组键,后一个完全取代前一个 -
array_replace_recursive:对每个子键递归执行替换,适合配置类数据叠加 - 注意:它不处理数字索引数组的追加,只认关联键;数值索引仍会被后值覆盖
$base = json_decode('{"db":{"host":"localhost","port":3306}}', true);
$override = json_decode('{"db":{"port":5432,"user":"admin"}}', true);
$result = array_replace_recursive($base, $override);
// 结果中 db 是 ["host"=>"localhost","port"=>5432,"user"=>"admin"]
遇到json_decode返回null,八成是编码或格式问题
不是所有字符串都能被json_decode成功解析,尤其从文件、API或表单读入时。返回null不等于空,是解析失败信号。
- 先用
json_last_error()和json_last_error_msg()查具体原因,比如JSON_ERROR_UTF8说明含非法UTF-8字节 - 前端传来的JSON可能带BOM头或换行符,用
trim()和mb_convert_encoding($s, 'UTF-8', 'auto')预处理 - 别依赖
isset()判断解析结果,用is_array()或is_null()明确检查
大批量JSON合并时,别在循环里反复json_encode/json_decode
每调用一次json_decode都要做词法分析和语法树构建,100次就是100次开销。真实场景中,比如日志聚合、API响应组装,容易在这里卡住。
立即学习“PHP免费学习笔记(深入)”;
- 如果原始数据本来就是PHP数组(比如从DB查出),跳过
json_decode,直接array_merge - 若必须从JSON开始,一次性解码全部输入,合并完再统一编码,避免中间反复编解码
- 确认
json_encode输出是否需要JSON_UNESCAPED_UNICODE等标志——多一个标志就多一次遍历,不用就别加
真正难的不是怎么合,是怎么保证合完还是合法JSON、键不丢、类型不崩、中文不乱、大数不转成科学计数。这些细节一漏,下游解析就报错,而且错得没提示。











