php中必须先json_decode将json字符串转为数组(需加true参数),再用ksort/asort/usort等排序,最后可选json_encode;直接对json字符串排序无效,嵌套结构需递归处理。

PHP 中 json_decode 后才能排序,原 JSON 字符串不能直接排
JSON 本质是字符串,PHP 没有“对 JSON 排序”这个操作——必须先用 json_decode 转成 PHP 数组(或对象),再对数组排序,最后可选地用 json_encode 转回。常见错误是试图对 $json_str 直接调用 ksort 或 usort,结果报错或静默失败。
注意:如果原始 JSON 是对象形式(即外层是 {}),json_decode($json, true) 必须加第二个参数 true,否则返回 stdClass 对象,无法用数组函数排序。
- 不加
true→ 返回对象 →ksort()会警告“expects parameter 1 to be array” - 含中文 key 或数字 key 混用时,
json_decode默认保留原始 key 类型(字符串 key 不会转成整型) - 深层嵌套 JSON 排序需递归处理,不能只排顶层
按 key 排序用 ksort / krsort,注意关联数组特性
PHP 关联数组的 key 顺序在遍历时会被保留,所以 ksort(升序)和 krsort(降序)能真正改变输出顺序。但它们只作用于**当前层级**,且要求输入是数组(不是对象)。
示例:
立即学习“PHP免费学习笔记(深入)”;
$data = json_decode('{"c":1,"a":3,"b":2}', true);
ksort($data); // 变成 ["a"=>3,"b"=>2,"c"=>1]
echo json_encode($data); // {"a":3,"b":2,"c":1}
- key 是纯数字字符串(如
"10"、"2")时,ksort按字典序排("10" ),不是数值序;要数值排序得用 <code>uksort+intval - key 含 Unicode(如中文、emoji)时,
ksort按 UTF-8 字节序排,可能不符合预期;需用uksort配合mb_strcoll - PHP 7.4+ 支持
array_key_first/array_key_last,但不影响排序本身
按 value 排序要用 asort / arsort 或 usort,区分是否保留 key
asort 和 arsort 保持 key-value 关联(适合下拉选项等需要 key 映射的场景),而 usort 会重置 key 为数字索引(适合纯列表)。选错会导致前端拿不到原始 key。
常见误用:usort 传入关联数组后 key 全变成 0,1,2...,json_encode 输出方括号 [] 而非花括号 {}。
- 要保留 key → 用
asort($arr)(升序)或arsort($arr)(降序) - value 是多维(如数组或对象)→ 必须用
usort或uasort,并写比较函数 - value 含 null/bool/int/string 混合类型时,
asort的默认比较可能出人意料(例如false ),建议显式用 <code>uasort
嵌套结构排序必须手动递归,PHP 没有内置深度排序函数
比如 JSON 里有个 "users" 数组,每个 user 是对象,你想按 user.name 排序——这没法靠单层 usort 解决,因为 usort 只作用于数组元素本身,不自动深入子字段。
正确做法是先提取目标字段做比较,或用匿名函数访问嵌套值:
$data = json_decode($json, true);
usort($data['users'], function($a, $b) {
return strcmp($a['name'] ?? '', $b['name'] ?? '');
});
- 嵌套 key 不存在时(如
$a['name']为 null),直接访问会触发 notice;务必用??或isset()防御 - 多级排序(先按 name,name 相同再按 age)需在比较函数中嵌套判断,返回 0 才进下一步
- 不要试图用
array_walk_recursive排序——它只遍历值,不提供引用修改能力
深层结构越复杂,越容易漏掉某一层没排序。最稳妥的方式是把排序逻辑封装成函数,明确标注作用域(如 “仅排序 users 数组内元素”),避免误操作其他字段。











