從 API/資料庫獲取的二維數組 (列表數據),需按單一或多個欄位排序:如商品按「銷量降序、價格升序」、用戶按「註冊時間降序、等級升序」。
$data = [
['volume' => 67, 'edition' => 2],
['volume' => 86, 'edition' => 1],
['volume' => 85, 'edition' => 6],
['volume' => 98, 'edition' => 2],
['volume' => 86, 'edition' => 6],
['volume' => 67, 'edition' => 7],
];
// 1. 提取排序列 (必須保持鍵名對應)
$volume = array_column($data, 'volume');
$edition = array_column($data, 'edition');
// 2. 多鍵值排序:先 volume 降序,再 edition 升序
array_multisort($volume, SORT_DESC, $edition, SORT_ASC, $data);
/* 結果:
[
['volume'=>98, 'edition'=>2],
['volume'=>86, 'edition'=>1], // edition 1 < 6
['volume'=>86, 'edition'=>6],
['volume'=>85, 'edition'=>6],
['volume'=>67, 'edition'=>2], // edition 2 < 7
['volume'=>67, 'edition'=>7],
]
*/
/**
* 通用多欄位排序封裝
* @param array $data 待排序二維數組
* @param array $specs 排序規則 [['欄位', SORT_ASC|SORT_DESC, SORT_REGULAR|SORT_NUMERIC|SORT_STRING], ...]
* @return void 原地排序
*/
function multiSort(array &$data, array $specs): void
{
$args = [];
foreach ($specs as $spec) {
[$col, $order, $type] = $spec + [null, SORT_ASC, SORT_REGULAR];
$args[] = array_column($data, $col);
$args[] = $order;
$args[] = $type;
}
$args[] = &$data; // 最後必須是引用
array_multisort(...$args);
}
// 使用
multiSort($data, [
['volume', SORT_DESC, SORT_NUMERIC],
['edition', SORT_ASC, SORT_NUMERIC],
]);
/**
* 單欄位排序封裝
* @param array $data 二維數組
* @param string $key 排序欄位
* @param string $order 'asc'|'desc'
* @return array 新數組 (不修改原數組)
*/
function arraySort(array $data, string $key, string $order = 'asc'): array
{
$keyValues = array_column($data, $key);
$order === 'asc' ? asort($keyValues) : arsort($keyValues);
$sorted = [];
foreach ($keyValues as $k => $v) {
$sorted[] = $data[$k];
}
return $sorted;
}
/** 多欄位 usort 版 (支援任意比較邏輯) */
function multiSortUsort(array $data, array $specs): array
{
usort($data, function($a, $b) use ($specs) {
foreach ($specs as $spec) {
[$col, $order, $type] = $spec + [null, 'asc', 'regular'];
$va = $a[$col] ?? null;
$vb = $b[$col] ?? null;
// 類型轉換
if ($type === 'numeric') { $va = (float)$va; $vb = (float)$vb; }
elseif ($type === 'string') { $va = (string)$va; $vb = (string)$vb; }
$cmp = $va <=> $b; // PHP 7+ 太空船操作符
if ($cmp !== 0) {
return $order === 'asc' ? $cmp : -$cmp;
}
}
return 0;
});
return $data;
}
// 使用
$sorted = multiSortUsort($data, [
['volume', 'desc', 'numeric'],
['edition', 'asc', 'numeric'],
]);
適用於:**排序鍵值唯一、需保持鍵名、數據量大** 的情況。
function sortByKeyUnique(array $data, string $key, bool $asc = true): array
{
// 鍵值翻轉:值變鍵,鍵變值
$flipped = [];
foreach ($data as $k => $v) {
$val = $v[$key];
// 處理重複值:追加原鍵保證唯一
$flipped[$val . '#' . $k] = $k;
}
$asc ? ksort($flipped) : krsort($flipped);
$result = [];
foreach ($flipped as $origKey) {
$result[] = $data[$origKey];
}
return $result;
}
$products = [
['id'=>1, 'name'=>'手機', 'brand'=>'蘋果', 'price'=>5999, 'sales'=>1200, 'rating'=>4.8],
['id'=>2, 'name'=>'筆記本', 'brand'=>'聯想', 'price'=>4999, 'sales'=>800, 'rating'=>4.5],
['id'=>3, 'name'=>'耳機', 'brand'=>'索尼', 'price'=>999, 'sales'=>3500, 'rating'=>4.7],
['id'=>4, 'name'=>'手錶', 'brand'=>'華為', 'price'=>1999, 'sales'=>2100, 'rating'=>4.6],
['id'=>5, 'name'=>'平板', 'brand'=>'小米', 'price'=>2499, 'sales'=>1500, 'rating'=>4.4],
];
// 需求:銷量降序 → 評分降序 → 價格升序
multiSort($products, [
['sales', SORT_DESC, SORT_NUMERIC],
['rating', SORT_DESC, SORT_NUMERIC],
['price', SORT_ASC, SORT_NUMERIC],
]);
/* 結果順序:
1. 耳機 (sales=3500)
2. 手錶 (sales=2100)
3. 平板 (sales=1500)
4. 手機 (sales=1200, rating=4.8)
5. 筆記本 (sales=800)
*/
| 方法 | 耗時 | 內存峰值 | 備註 |
|---|---|---|---|
| array_multisort | ~45ms | ~18 MB | C 底層實現,**最快** |
| usort + 太空船 | ~120ms | ~12 MB | 靈活、支援複雜邏輯 |
| arraySort (asort) | ~80ms | ~15 MB | 單欄位適用 |
| 鍵值翻轉 | ~60ms | ~20 MB | 鍵值唯一時極快 |
array_multisort 最後一個參數**必須是引用** &$datausort/array_multisort 會重置數字索引,關聯索引保留。需保留原鍵用 uksort 或翻轉法'100' vs 整數 100,指定 SORT_NUMERIC 強制數值比較SORT_REGULAR 下 NULL 排最前,SORT_NUMERIC 視為 0,自定義比較函數可控制ORDER BY 完成,PHP 僅做二次微調// 利用 enum 定義排序方向
enum SortDirection: string {
case ASC = 'asc';
case DESC = 'desc';
}
// 結構化排序規則
readonly class SortRule {
public function __construct(
public string $column,
public SortDirection $direction = SortDirection::ASC,
public int $type = SORT_REGULAR
) {}
}
// 管道式排序
function sortData(iterable $data, SortRule ...$rules): array
{
$arr = is_array($data) ? $data : iterator_to_array($data);
$args = [];
foreach ($rules as $rule) {
$args[] = array_column($arr, $rule->column);
$args[] = $rule->direction === SortDirection::ASC ? SORT_ASC : SORT_DESC;
$args[] = $rule->type;
}
$args[] = &$arr;
array_multisort(...$args);
return $arr;
}
// 使用
$sorted = sortData($products,
new SortRule('sales', SortDirection::DESC, SORT_NUMERIC),
new SortRule('rating', SortDirection::DESC, SORT_NUMERIC),
);
array_multisort:原生、多鍵值、C 級性能、語義清晰usort:跨欄位計算、自定義比較器、非標準排序array_column + asort:代碼少、易讀ORDER BY 利用索引,避免 PHP 內存壓力