Сортировка массива PHP: sort(), usort(), asort() и ksort()

sort($array) сортирует массив по возрастанию, на месте. Функция меняет переданную переменную и возвращает true, поэтому её вызывают отдельной строкой, а потом используют массив. rsort() сортирует по убыванию.

<?php
$numbers = [42, 7, 19, 3, 25];
sort($numbers);
print_r($numbers);

$fruits = ["pear", "apple", "fig", "banana"];
rsort($fruits);
print_r($fruits);

В PHP есть функция сортировки для каждого сочетания "по значению или по ключу", "по возрастанию или по убыванию" и "сохранять ключи или нет":

Сортировка ассоциативного массива по значению

sort() для ассоциативного массива выбрасывает ключи. Используйте asort(), чтобы сортировать по значению и оставить каждый ключ при его значении, или arsort(), чтобы наибольшие шли первыми.

<?php
$scores = ["Ada" => 92, "Bob" => 67, "Cy" => 85, "Dee" => 74];

$copy = $scores;
sort($copy);
print_r($copy); // names are gone

arsort($scores);
print_r($scores); // highest first, names kept

echo "Winner: " . array_key_first($scores) . "\n";

Сортировка массива по ключу через ksort

ksort() упорядочивает по ключу, krsort() по ключу в обратном порядке. Это удобно перед выводом настроек или сборкой строки запроса в стабильном порядке.

<?php
$params = ["page" => 2, "category" => "books", "author" => "le guin", "sort" => "year"];

ksort($params);
print_r($params);

echo http_build_query($params), "\n";

Свой порядок через usort и оператор spaceship

usort($array, $callback) позволяет самим задать порядок. Колбэк получает два элемента и возвращает отрицательное число, если первый должен идти раньше, положительное, если раньше второй, и 0, если они равны. Оператор spaceship <=> возвращает ровно это.

<?php
$words = ["banana", "fig", "cherry", "kiwi", "apple"];

// Shortest first
usort($words, fn($a, $b) => strlen($a) <=> strlen($b));
print_r($words);

// Longest first: swap $a and $b
usort($words, fn($a, $b) => strlen($b) <=> strlen($a));
print_r($words);

У banana и cherry одинаковая длина, поэтому колбэк возвращает для них 0, и они остаются в прежнем порядке. Сортировка в PHP стабильна начиная с PHP 8.0: равные элементы сохраняют прежний порядок.

Сортировка многомерного массива по значению

Чтобы отсортировать список строк по одному полю, сравнивайте это поле в usort. Чтобы сортировать по двум полям, сравнивайте массивы: <=> сравнивает их поэлементно, поэтому второе поле решает только при равенстве первого.

<?php
$people = [
    ["name" => "Ada", "city" => "London", "age" => 36],
    ["name" => "Linus", "city" => "Helsinki", "age" => 28],
    ["name" => "Grace", "city" => "New York", "age" => 45],
    ["name" => "Alan", "city" => "London", "age" => 41],
];

// By age, youngest first
usort($people, fn($a, $b) => $a["age"] <=> $b["age"]);
echo implode(", ", array_column($people, "name")), "\n";

// By city, then oldest first within a city
usort($people, fn($a, $b) =>
    [$a["city"], $b["age"]] <=> [$b["city"], $a["age"]]
);
foreach ($people as $p) {
    echo "{$p['city']}: {$p['name']} ({$p['age']})\n";
}

Во втором сравнении $b["age"] стоит слева, а $a["age"] справа, и это переворачивает только порядок по возрасту. array_multisort(array_column($people, 'city'), SORT_ASC, array_column($people, 'age'), SORT_DESC, $people) даёт тот же порядок без колбэка: функция сортирует по извлечённым столбцам и переставляет $people соответственно.

Естественный порядок и флаги сортировки

По умолчанию PHP сравнивает числа как числа, а строки как строки. Имена файлов с числами сортируются неожиданно для людей: img10 идёт раньше img2, а все имена в верхнем регистре раньше всех имён в нижнем. Флаги меняют способ сравнения значений.

<?php
$files = ["img12.png", "img10.png", "img2.png", "IMG1.png"];

$plain = $files;
sort($plain);
print_r($plain);

$natural = $files;
sort($natural, SORT_NATURAL | SORT_FLAG_CASE);
print_r($natural);

$mixed = ["10", "9", "2", "1"];
sort($mixed, SORT_STRING);
print_r($mixed);

SORT_NATURAL читает последовательности цифр как числа, SORT_FLAG_CASE не учитывает регистр, а SORT_STRING принудительно сравнивает посимвольно даже числовые строки. natsort() и natcasesort() работают по той же идее, но сохраняют ключи.

Частая ошибка: присваивание результата sort

Каждая функция сортировки возвращает true и меняет переданный массив. Присваивание возвращаемого значения теряет массив:

<?php
$list = [3, 1, 2];

$sorted = sort($list);
var_dump($sorted); // bool(true), not an array
print_r($list);    // this is the sorted array

Если нужна отсортированная копия, а оригинал надо сохранить, сначала скопируйте массив в новую переменную и сортируйте копию, как в примере с asort выше делается с $copy.