ksort() 是 PHP 專門針對鍵名進行升序排序的陣列函式,最大特色是完整保留鍵值關聯關係。無論是關聯陣列、多維陣列,或是需依特定順序輸出資料的場景,ksort() 都是不可或缺的工具。本文將深入解析其語法、旗標、實戰範例與進階應用。
bool ksort ( array &$array [, int $sort_flags = SORT_REGULAR ] )
$array:參考傳遞,直接修改原陣列$sort_flags:排序比較模式(同 rsort())true 成功、false 失敗| 旗標 | 比較方式 | 典型用例 |
|---|---|---|
SORT_REGULAR | 依原型別比較(預設) | 鍵名型別一致的一般陣列 |
SORT_NUMERIC | 鍵名轉數值比較 | 數字鍵名字串(如 "10", "2", "1") |
SORT_STRING | 鍵名視為字串比較 | 字串鍵名、避免數值轉換干擾 |
SORT_LOCALE_STRING | 依 locale 字串比較 | 多語言鍵名、特定語系排序規則 |
<?php
$myArray = [
"e" => "Dog",
"b" => "Cat",
"c" => "Horse",
"a" => "Apple"
];
ksort($myArray);
print_r($myArray);
/*
Array
(
[a] => Apple
[b] => Cat
[c] => Horse
[e] => Dog
)
// 鍵名按 ASCII 升序:a, b, c, e
// 值隨鍵名移動,關聯關係完整保留
*/
?>
數字字串鍵名排序時,旗標選擇直接決定結果:
<?php
$numericKeys = [
"10" => "十",
"2" => "二",
"1" => "一",
"20" => "二十"
];
// 字串排序(預設):"1", "10", "2", "20"
ksort($numericKeys, SORT_STRING);
print_r($numericKeys);
/*
[1] => 一
[10] => 十
[2] => 二
[20] => 二十
*/
// 數值排序:1, 2, 10, 20
$numericKeys = ["10" => "十", "2" => "二", "1" => "一", "20" => "二十"];
ksort($numericKeys, SORT_NUMERIC);
print_r($numericKeys);
/*
[1] => 一
[2] => 二
[10] => 十
[20] => 二十
*/
?>
<?php
$logs = [
"2024-01-15 10:30" => "用戶登入",
"2024-01-14 08:15" => "系統啟動",
"2024-01-15 14:22" => "資料備份",
"2024-01-13 22:00" => "例行維護"
];
ksort($logs); // ISO 8601 日期字串字典序即為時間序
foreach ($logs as $time => $event) {
echo "[{$time}] {$event}<br>";
}
// 輸出按時間正序排列
?>
<?php
$products = [
['id' => 3, 'name' => '滑鼠', 'price' => 500],
['id' => 1, 'name' => '鍵盤', 'price' => 1200],
['id' => 2, 'name' => '螢幕', 'price' => 8000],
];
// 依 id 升序排序(ksort 只能排單層鍵名,多維需用 array_multisort)
$ids = array_column($products, 'id');
array_multisort($ids, SORT_ASC, $products);
print_r($products);
// 結果依 id: 1, 2, 3 排序
?>
<?php
function deepKsort(&$array) {
ksort($array);
foreach ($array as &$value) {
if (is_array($value)) {
deepKsort($value);
}
}
}
$data = [
'z' => ['b' => 2, 'a' => 1],
'a' => ['d' => 4, 'c' => 3]
];
deepKsort($data);
print_r($data);
/*
所有層級鍵名皆升序:
[a] => [c => 3, d => 4]
[z] => [a => 1, b => 2]
*/
?>
| 函式 | 排序依據 | 順序 | 保留鍵值關聯 |
|---|---|---|---|
ksort() | 鍵名 | 升序 | ✅ |
krsort() | 鍵名 | 降序 | ✅ |
uksort() | 鍵名(自訂比較) | 自訂 | ✅ |
asort() | 值 | 升序 | ✅ |
arsort() | 值 | 降序 | ✅ |
natsort() | 值(自然排序) | 升序 | ✅ |
ksort() 回傳 bool,非排序後陣列。錯誤:$sorted = ksort($arr); 正確:ksort($arr); $sorted = $arr;uksort($arr, 'strcasecmp')SORT_LOCALE_STRING 需配合 setlocale():且受系統支援度影響,跨平台部署需測試ksort() 效能極佳(微秒級)ORDER BY 或維護已排序資料結構(如 SplFixedArray + 二分搜尋插入)array_keys() 取出鍵名排序後重組,避免修改原陣列ksort() 是處理關聯陣列鍵名排序的標準工具,核心優勢在於保留鍵值關聯。掌握 SORT_NUMERIC 與 SORT_STRING 的差異、善用 uksort() 處理複雜比較邏輯、理解多維陣列需搭配 array_multisort(),能讓你在資料整理、報表產出、API 回應排序等場景游刃有餘。