本文详解如何使用 php 解析含嵌套 players 数组的 json 数据，提取所有玩家信息，并按 wonamount 字段从高到低排序输出，避免常见“array”误输出问题。
本文详解如何使用 php 解析含嵌套 players 数组的 json 数据，提取所有玩家信息，并按 wonamount 字段从高到低排序输出，避免常见“array”误输出问题。
在处理赛事类 API 返回的 JSON 数据时，常遇到多层嵌套结构（如 players 为对象数组），直接 echo 数组变量会输出字符串 "Array"——这是因 PHP 无法隐式转换数组为字符串所致。正确做法是：先解码 JSON，再提取、排序、遍历输出。
✅ 正确步骤详解
JSON 解码为关联数组
使用 json_decode($json, true) 将 JSON 字符串转为可操作的 PHP 关联数组（true 参数确保返回数组而非对象，便于键名访问）：提取 players 子数组
$players = $data['players']; 安全获取嵌套数组；建议添加判空检查（见注意事项）。-
按 wonAmount 降序排序
利用 array_multisort() 配合辅助列实现高效排序：- 构建 $wonAmount 索引数组，存储每个玩家的 wonAmount 值；
- 调用 array_multisort($wonAmount, SORT_DESC, $players) —— 此操作原地重排 $players，无需返回值。
安全遍历并格式化输出
推荐使用 printf() 或 HTML 表格增强可读性，避免裸 echo：
<?php
$json_data = '{
"tournamentID": 65,
"gameType": "Holdem",
"name": "TRI KRALJA ZA EVROPU",
"start": "2022-04-07 13:30:00",
"status": "Finished",
"buyIn": 100000,
"entryFee": 10000,
"guaranteedPrize": 12500000,
"rebuyFee": 100000,
"rebuyRake": 10000,
"addonFee": 0,
"addonRake": 0,
"tableSize": 9,
"speed": "Turbo",
"players": [
{"id": 1000000, "alias": "demo1", "rank": 1, "wonAmount": 6250000},
{"id": 1000005, "alias": "demo6", "rank": 2, "wonAmount": 3750000},
{"id": 1000087, "alias": "demo10", "rank": 3, "wonAmount": 2500000},
{"id": 1000008, "alias": "demo9", "rank": 4, "wonAmount": 0}
]
}';
$data = json_decode($json_data, true);
// ✅ 关键：检查 JSON 解码是否成功 & players 是否存在
if (json_last_error() !== JSON_ERROR_NONE) {
die('JSON 解析失败：' . json_last_error_msg());
}
if (!isset($data['players']) || !is_array($data['players'])) {
die('players 字段缺失或非数组');
}
$players = $data['players'];
// 构建排序依据数组
$wonAmounts = array_column($players, 'wonAmount'); // 更简洁替代手动 foreach
array_multisort($wonAmounts, SORT_DESC, $players);
// 输出排序后结果（带表头更清晰）
echo "<table border='1' style='border-collapse: collapse; width: 100%;'>\n";
echo "<tr><th>排名</th><th>玩家ID</th><th>昵称</th><th>奖金（金币）</th></tr>\n";
foreach ($players as $player) {
printf(
"<tr><td>%d</td><td>%d</td><td>%s</td><td>%s</td></tr>\n",
$player['rank'],
$player['id'],
htmlspecialchars($player['alias']),
number_format($player['wonAmount'], 0, '', ',')
);
}
echo "</table>";
?>⚠️ 注意事项与最佳实践
- 错误处理不可省略：始终检查 json_decode() 返回值及 json_last_error()，避免静默失败；
- 避免 print_r() / var_dump() 用于生产环境输出：它们用于调试，而非用户展示；
- XSS 防护：输出用户数据（如 alias）前务必用 htmlspecialchars() 转义；
- 性能提示：对于超大 players 数组（如 >10,000 条），可考虑 usort() + 匿名函数，但 array_multisort() 在中等规模下效率更高；
-
替代排序方案（PHP 7.0+）：
usort($players, fn($a, $b) => $b['wonAmount'] <=> $a['wonAmount']);
掌握此流程后，你可轻松扩展功能——例如筛选 wonAmount > 0 的获奖者、计算奖金总和、或导出 CSV 报表。核心原则始终如一：解码 → 提取 → 验证 → 排序 → 安全输出。
