Ordenar array em PHP: sort(), usort(), asort() e ksort()

sort($array) ordena um array em ordem crescente, no lugar. Ele altera a variável que você passa e retorna true, então você o chama numa linha sozinho e depois usa o array. rsort() ordena em ordem decrescente.

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

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

O PHP tem uma função de ordenação para cada combinação de "por valor ou por chave", "crescente ou decrescente" e "manter as chaves ou não":

Ordenar um array associativo por valor

sort() num array associativo joga as chaves fora. Use asort() para ordenar por valor mantendo cada chave com seu valor, ou arsort() para os maiores primeiro.

<?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 um array por chave com ksort

ksort() ordena pela chave, krsort() pela chave em ordem inversa. É útil antes de imprimir configurações ou montar uma query string numa ordem estável.

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

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

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

Ordem personalizada com usort e o operador spaceship

usort($array, $callback) deixa você decidir a ordem. O callback recebe dois elementos e retorna um número negativo se o primeiro deve vir antes, um número positivo se o segundo deve vir antes, e 0 se forem iguais. O operador spaceship <=> retorna exatamente isso.

<?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 e cherry têm o mesmo tamanho, então o callback retorna 0 para elas e elas ficam na ordem em que já estavam. A ordenação do PHP é estável desde o PHP 8.0: elementos iguais mantêm a ordem anterior.

Ordenar um array multidimensional por um valor

Para ordenar uma lista de linhas por um campo, compare esse campo no usort. Para ordenar por dois campos, compare arrays: <=> os compara elemento por elemento, então o segundo campo só desempata o primeiro.

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

A segunda comparação coloca $b["age"] do lado esquerdo e $a["age"] do lado direito, o que inverte só a ordem da idade. array_multisort(array_column($people, 'city'), SORT_ASC, array_column($people, 'age'), SORT_DESC, $people) dá a mesma ordem sem callback: ele ordena pelas colunas extraídas e reordena $people para acompanhar.

Ordem natural e flags de ordenação

Por padrão, o PHP compara números como números e strings como strings. Nomes de arquivos com números dentro ficam numa ordem que as pessoas não esperam: img10 vem antes de img2, e todo nome com maiúscula vem antes de todo nome com minúscula. As flags mudam como os valores são comparados.

<?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 lê sequências de dígitos como números, SORT_FLAG_CASE ignora maiúsculas e minúsculas, e SORT_STRING força uma comparação caractere a caractere mesmo para strings numéricas. natsort() e natcasesort() seguem a mesma ideia, mas mantêm as chaves.

Erro comum: atribuir o resultado do sort

Toda função de ordenação retorna true e altera o array que você passa. Atribuir o valor de retorno perde o 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

Se você precisa de uma cópia ordenada e quer manter o original, copie o array para uma nova variável antes e ordene a cópia, como o exemplo do asort acima faz com $copy.