array_multisort
(PHP 4, PHP 5, PHP 7, PHP 8)
array_multisort — 對多個數組或多維陣列進行排序
說明
array
&$array1,mixed
$array1_sort_order = SORT_ASC,mixed
$array1_sort_flags = SORT_REGULAR,mixed
...$rest): bool
array_multisort() 可以用來一次對多個數組進行排序，或者根據某一維或多維對多維陣列進行排序。
關聯（string）鍵名保持不變，但數字鍵名會被重新索引。
注意:
如果兩個成員完全相同，那麼它們將保持原來的順序。 在 PHP 8.0.0 之前，它們在排序陣列中的相對順序是未定義的。
參數
注意:
重置陣列中的內部指針，指向第一個元素。
-
array1 -
要排序的 array。
-
array1_sort_order -
之前 array 參數要排列的順序。
SORT_ASC按照上升順序排序，SORT_DESC按照下降順序排序。此參數可以和
array1_sort_flags互換，也可以完全刪除，預設是SORT_ASC。 -
array1_sort_flags -
為 array 參數設定選項：
排序型別標誌：
-
SORT_REGULAR- 將專案按照通常方法比較（不修改型別） -
SORT_NUMERIC- 按照數字大小比較 -
SORT_STRING- 按照字串比較 -
SORT_LOCALE_STRING- 根據目前的本地化設定，按照字串比較。 它會使用 locale 資訊，可以通過 setlocale() 修改此資訊。 -
SORT_NATURAL- 以字串的"自然排序"，類似 natsort() -
SORT_FLAG_CASE- 可以組合 (按位或 OR)SORT_STRING或者SORT_NATURAL大小寫不敏感的方式排序字串。
參數可以和
array1_sort_order交換或者省略，預設情況下是SORT_REGULAR。 -
-
rest -
可選的選項，可提供更多陣列，跟隨在 sort order 和 sort flag 之後。 提供的陣列和之前的陣列要有相同數量的元素。 換言之，排序是按字典順序排列的。
返回值
成功時返回 true， 或者在失敗時返回 false。
範例
示例 #1 多個數組排序
<?php
$ar1 = array(10, 100, 100, 0);
$ar2 = array(1, 3, 2, 4);
array_multisort($ar1, $ar2);
var_dump($ar1);
var_dump($ar2);
?>
這個例子里，排序后，第一個陣列會包含 0、 10、 100、 100。 第二個陣列會包含 4、1、 2、 3。 第二個陣列里的專案對應第一個陣列后也進行了排序（100 和 100）。
array(4) {
[0]=> int(0)
[1]=> int(10)
[2]=> int(100)
[3]=> int(100)
}
array(4) {
[0]=> int(4)
[1]=> int(1)
[2]=> int(2)
[3]=> int(3)
}
示例 #2 排序多維陣列
<?php
$ar = array(
array("10", 11, 100, 100, "a"),
array( 1, 2, "2", 3, 1)
);
array_multisort($ar[0], SORT_ASC, SORT_STRING,
$ar[1], SORT_NUMERIC, SORT_DESC);
var_dump($ar);
?>
本例中在排序后，第一個陣列將變成 "10"，100，100，11，"a"（被當作字串以升序排列）。第二個陣列將包含 1, 3, "2", 2, 1（被當作數字以降序排列）。
array(2) {
[0]=> array(5) {
[0]=> string(2) "10"
[1]=> int(100)
[2]=> int(100)
[3]=> int(11)
[4]=> string(1) "a"
}
[1]=> array(5) {
[0]=> int(1)
[1]=> int(3)
[2]=> string(1) "2"
[3]=> int(2)
[4]=> int(1)
}
}
示例 #3 對數據庫結果進行排序
本例中 data 陣列中的每個單元表示一個表中的一行。這是典型的數據庫記錄的數據集合。
例子中的數據如下：
volume | edition
-------+--------
67 | 2
86 | 1
85 | 6
98 | 2
86 | 6
67 | 7
數據全都存放在名為 data 的陣列中。這通常是通過循環從數據庫取得的結果，例如 mysql_fetch_assoc()。
<?php
$data[] = array('volume' => 67, 'edition' => 2);
$data[] = array('volume' => 86, 'edition' => 1);
$data[] = array('volume' => 85, 'edition' => 6);
$data[] = array('volume' => 98, 'edition' => 2);
$data[] = array('volume' => 86, 'edition' => 6);
$data[] = array('volume' => 67, 'edition' => 7);
?>
本例中將把 volume 降序排列，把 edition 升序排列。
現在有了包含有行的陣列，但是 array_multisort() 需要一個包含列的陣列，因此用以下程式碼來取得列，然後排序。
<?php
// 取得列的列表
foreach ($data as $key => $row) {
$volume[$key] = $row['volume'];
$edition[$key] = $row['edition'];
}
// 你可以使用 array_column() 代替上面的程式碼
$volume = array_column($data, 'volume');
$edition = array_column($data, 'edition');
// 將數據根據 volume 降序排列，根據 edition 升序排列
// 把 $data 作為最後一個參數，以通用鍵排序
array_multisort($volume, SORT_DESC, $edition, SORT_ASC, $data);
?>
數據集合現在排好序了，結果如下：
volume | edition
-------+--------
98 | 2
86 | 1
86 | 6
85 | 6
67 | 2
67 | 7
示例 #4 不區分大小寫字母排序
SORT_STRING 和
SORT_REGULAR
都是區分大小寫字母的，大寫字母會排在小寫字母之前。
要進行不區分大小寫的排序，就要按照原陣列的小寫字母拷貝來排序。
<?php
$array = array('Alpha', 'atomic', 'Beta', 'bank');
$array_lowercase = array_map('strtolower', $array);
array_multisort($array_lowercase, SORT_ASC, SORT_STRING, $array);
print_r($array);
?>
以上例程會輸出：
Array
(
[0] => Alpha
[1] => atomic
[2] => bank
[3] => Beta
)