Ordenar arrays en PHP: sort(), usort(), asort() y ksort()

sort($array) ordena un array en orden ascendente, en el sitio. Cambia la variable que le pasas y devuelve true, así que la llamas en su propia línea y luego usas el array. rsort() ordena en orden descendente.

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

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

PHP tiene una función de ordenación para cada combinación de "por valor o por clave", "ascendente o descendente" y "conservar las claves o no":

Ordenar un array asociativo por valor

sort() con un array asociativo descarta las claves. Usa asort() para ordenar por valor y mantener cada clave con su valor, o arsort() para poner primero el más alto.

<?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";

Ordenar un array por clave con ksort

ksort() ordena por clave y krsort() por clave a la inversa. Es útil antes de imprimir ajustes o de construir una query string en un orden estable.

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

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

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

Orden personalizado con usort y el operador nave espacial

usort($array, $callback) te deja decidir el orden. El callback recibe dos elementos y devuelve un número negativo si el primero debe ir antes, un número positivo si debe ir antes el segundo, y 0 si son iguales. El operador nave espacial <=> devuelve exactamente eso.

<?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 y cherry tienen la misma longitud, así que el callback devuelve 0 para ellas y se quedan en el orden que ya tenían. La ordenación de PHP es estable desde PHP 8.0: los elementos iguales mantienen su orden anterior.

Ordenar un array multidimensional por un valor

Para ordenar una lista de filas por un campo, compara ese campo en usort. Para ordenar por dos campos, compara arrays: <=> los compara elemento a elemento, así que el segundo campo solo desempata el primero.

<?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";
}

La segunda comparación pone $b["age"] en el lado izquierdo y $a["age"] en el derecho, lo que invierte solo el orden por edad. array_multisort(array_column($people, 'city'), SORT_ASC, array_column($people, 'age'), SORT_DESC, $people) da el mismo orden sin callback: ordena por las columnas extraídas y reordena $people para que coincida.

Orden natural y flags de ordenación

Por defecto, PHP compara los números como números y las cadenas como cadenas. Los nombres de archivo con números se ordenan de una forma que la gente no espera: img10 va antes que img2, y todos los nombres en mayúsculas van antes que todos los de minúsculas. Los flags cambian cómo se comparan los valores.

<?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 lee las secuencias de dígitos como números, SORT_FLAG_CASE ignora mayúsculas y minúsculas, y SORT_STRING fuerza una comparación carácter a carácter incluso con cadenas numéricas. natsort() y natcasesort() son la misma idea pero conservan las claves.

Error frecuente: asignar el resultado de sort

Todas las funciones de ordenación devuelven true y cambian el array que les pasas. Asignar el valor de retorno hace que pierdas el array:

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

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

Si necesitas una copia ordenada y quieres conservar el original, copia antes el array en una variable nueva y ordena la copia, como hace el ejemplo de asort de arriba con $copy.