问题描述：JSON结构中的意外数组
在php开发中，我们经常需要将php数组转换为json字符串，以便于前端或其他服务消费。然而，有时在构建复杂json结构时，可能会遇到输出结果中包含不必要的数组括号（[]）的情况，这与我们期望的关联对象结构（{}）不符。
考虑以下PHP代码片段，它尝试构建一个包含加密货币汇率数据的JSON结构：
"BTC"],
["symbol" => "ETH"],
// ... 更多数据
];
$data = array(
'base' => 'USD',
'alter' => 'ETH',
'data' => array() // 初始化一个空数组
);
foreach ($cryptos as $row) {
$sy = $row["symbol"];
// 原始代码：使用 [] 进行追加
$data['data'][] = array(
"$sy" => [
"rate" => 1.552000000000000,
"min" => 1.0077600000000000,
"max" => 10.077600000000000,
"code" => $row["symbol"],
"dp" => 8
],
);
}
echo "var fxCur = " . json_encode($data, JSON_PRETTY_PRINT);
?>运行上述代码，json_encode会生成如下JSON输出：
{
"base":"USD",
"alter":"ETH",
"data":[
{
"BTC":{
"rate": 1.552,
"min": 1.00776,
"max": 10.0776,
"code":"BTC",
"dp":8
}
},
{
"ETH":{
"rate": 1.552,
"min": 1.00776,
"max": 10.0776,
"code":"ETH",
"dp":8
}
}
]
}可以看到，"data"字段的值是一个JSON数组（由[]包裹），其内部包含多个JSON对象，每个对象又只有一个键值对（例如{"BTC": {...}}）。然而，我们期望的结构是"data"字段直接是一个JSON对象，其中键是加密货币符号，值是其对应的详细信息，如下所示：
{
"base":"USD",
"alter":"ETH",
"data":{
"BTC":{
"rate": 1.552,
"min": 1.00776,
"max": 10.0776,
"code":"BTC",
"dp":8
},
"ETH":{
"rate": 1.552,
"min": 1.00776,
"max": 10.0776,
"code":"ETH",
"dp":8
}
}
}根源分析：PHP数组构建与JSON编码
问题的根源在于PHP中数组的构建方式以及json_encode函数对不同类型PHP数组的处理。
立即学习“PHP免费学习笔记（深入）”；
在原始代码中，这行：
$data['data'][] = array( "$sy" => [...] );
使用了[]操作符。在PHP中，当对一个数组使用[]并赋值时，它会将新元素追加到数组的末尾，并自动分配一个递增的整数索引。这意味着$data['data']会成为一个索引数组（或称作列表），其元素依次为：
- [0] => ["BTC" => {...}]
- [1] => ["ETH" => {...}]
- ...
当json_encode处理一个PHP索引数组（即所有键都是连续的整数，从0开始）时，它会将其编码为JSON数组（[]）。如果数组中存在非整数键或非连续的整数键，json_encode则会将其编码为JSON对象（{}）。
因此，为了让"data"字段被编码为JSON对象而不是JSON数组，我们需要确保$data['data']在PHP中是一个关联数组，即其键不是连续的整数索引。
解决方案：构建关联数组
要实现期望的JSON结构，我们需要将foreach循环内部的数组赋值方式从追加（[]）改为直接使用加密货币符号作为键进行赋值。
修改后的代码如下：
"BTC"],
["symbol" => "ETH"],
// ... 更多数据
];
$data = array(
'base' => 'USD',
'alter' => 'ETH',
'data' => array() // 初始化一个空数组
);
foreach ($cryptos as $row) {
$sy = $row["symbol"];
// 修正后的代码：直接使用 $sy 作为键进行赋值
$data['data'][$sy] = [
"rate" => 1.552000000000000,
"min" => 1.0077600000000000,
"max" => 10.077600000000000,
"code" => $row["symbol"],
"dp" => 8
];
}
echo "var fxCur = " . json_encode($data, JSON_PRETTY_PRINT);
?>在这段修正后的代码中，关键的变化在于：
$data['data'][$sy] = [...];
这里，我们不再使用[]进行追加，而是直接将$sy（例如"BTC"、"ETH"）作为键，将右侧的详细信息数组作为值赋给$data['data']。这样，$data['data']在PHP中就成为了一个关联数组，其结构类似于：
$data['data'] = [
"BTC" => ["rate" => ..., "min" => ..., ...],
"ETH" => ["rate" => ..., "min" => ..., ...],
// ...
];当json_encode处理这种关联数组时，它会将其编码为JSON对象（{}），从而得到我们期望的输出。
预期输出
使用修正后的代码，json_encode将生成如下符合预期的JSON输出：
{
"base":"USD",
"alter":"ETH",
"data":{
"BTC":{
"rate": 1.552,
"min": 1.00776,
"max": 10.0776,
"code":"BTC",
"dp":8
},
"ETH":{
"rate": 1.552,
"min": 1.00776,
"max": 10.0776,
"code":"ETH",
"dp":8
}
}
}可以看到，"data"字段现在是一个JSON对象，而不是数组，这正是我们想要的结果。
注意事项与最佳实践
-
理解PHP数组类型与JSON映射：
- PHP索引数组 (List): 如果PHP数组的所有键都是连续的整数（从0开始），json_encode会将其转换为JSON数组 []。
- PHP关联数组 (Map/Dictionary): 如果PHP数组包含非整数键或非连续的整数键，json_encode会将其转换为JSON对象 {}。
- 明确你想要在JSON中表示的是一个有序列表（JSON数组）还是一个键值对集合（JSON对象），然后相应地构建你的PHP数组。
数据结构设计： 在设计数据结构时，应提前考虑最终的JSON输出形式。如果需要通过一个动态的键来访问数据，那么JSON对象是更合适的选择。如果数据是一个无序或有序的项的集合，且通过索引访问，那么JSON数组更合适。
可读性： 使用JSON_PRETTY_PRINT选项（如示例所示）可以使输出的JSON字符串更具可读性，尤其是在开发和调试阶段。
总结
通过本教程，我们了解了在PHP中构建JSON数据时，如何避免json_encode生成不必要的数组括号。核心在于理解PHP中索引数组和关联数组的区别，并根据期望的JSON结构，灵活地选择合适的数组构建方式。当需要将PHP数组映射为JSON对象时，务必使用字符串键或非连续整数键来构建PHP数组，而不是简单地通过[]追加元素。掌握这一技巧，将有助于您生成更精确、更符合预期的JSON数据结构。
