Ordenando Arrays

O PHP tem muitas funções para lidar com ordenação de arrays, e esse documento existe para ajudar o desenvolvedor a lidar com elas.

As principais diferenças são:

  • Algumas ordenam com base nas chaves do array, enquanto outras pelos valores: $array['chave'] = 'valor';
  • A correlação entre as chaves e os valores do array não são mantidas depois da ordenação, o que pode fazer com que as chaves sejam resetadas numericamente (0, 1, 2, ...)
  • A ordem da ordenação: alfabética, ascendente (menor para maior), descendente (maior para menor), natural, aleatório, ou definida pelo usuário
  • Nota: Todas essas funções agem diretamente na própria variável do array, ao invés de retornar um novo array ordenado
  • Se qualquer uma dessas funções avaliar dois membros como iguais então eles retém sua ordem original. Antes do PHP 8.2.0, sua ordem eram indefinida (a ordenação não é estável).

Atributos das funções de ordenação
Nome da função Ordena por Mantém a associação de chaves Ordem da ordenação Funções relacionadas
array_multisort() valor string chaves sim, int chaves não primeiro array ou opções de ordenação array_walk()
asort() valor sim ascendente arsort()
arsort() valor sim descendente asort()
krsort() chave sim descendente ksort()
ksort() chave sim ascendente krsort()
natcasesort() valor sim natural, não sensível a maiúsculas natsort()
natsort() valor sim natural natcasesort()
rsort() valor não descendente sort()
shuffle() valor não random array_rand()
sort() valor não menor para maior rsort()
uasort() valor sim definido pelo usuário uksort()
uksort() chave sim definido pelo usuário uasort()
usort() valor não definido pelo usuário uasort()

adicione uma nota

Notas Enviadas por Usuários (em inglês) 2 notes

up
144
"Matthew Rice"
11 years ago
While this may seem obvious, user-defined array sorting functions ( uksort(), uasort(), usort() ) will *not* be called if the array does not have *at least two values in it*.

The following code:

<?php

function usortTest($a, $b) {
var_dump($a);
var_dump($b);
return -
1;
}

$test = array('val1');
usort($test, "usortTest");

$test2 = array('val2', 'val3');
usort($test2, "usortTest");

?>

Will output:

string(4) "val3"
string(4) "val2"

The first array doesn't get sent to the function.

Please, under no circumstance, place any logic that modifies values, or applies non-sorting business logic in these functions as they will not always be executed.
up
4
oculiz at gmail dot com
13 years ago
Another way to do a case case-insensitive sort by key would simply be:

<?php
uksort
($array, 'strcasecmp');
?>

Since strcasecmp is already predefined in php it saves you the trouble to actually write the comparison function yourself.
To Top