array_multisort

array_multisort(array $array1, [mixed $array1_sort_order], [mixed $array1_sort_flags], mixed ...$rest): true
```php

`array_multisort` sirve para ordenar simultáneamente varios arrays, o bien para ordenar un array multidimensional, siguiendo una u otra de sus dimensiones.

Las claves asociativas (`string`) serán mantenidas, pero las claves numéricas serán reindexadas.

> [!NOTE]
> Si dos miembros se comparan como iguales, mantienen su orden original. Anterior a PHP 8.0.0, su orden relativo en el array ordenado no está definido.

> [!NOTE]
> Reinicia el puntero interno del array al primer elemento.

## Parámetros

`array1`  
Un `array` a ordenar.

`array1_sort_order`  
El orden utilizado para ordenar el argumento anterior `array`. Puede ser la constante `SORT_ASC` para ordenar de forma ascendente, o la constante `SORT_DESC` para ordenar de forma descendente.

Este argumento puede ser asociado con el parámetro `array1_sort_flags` o simplemente omitido, en cuyo caso, la constante `SORT_ASC` será utilizada.

`array1_sort_flags`  
Opciones de ordenación del argumento `array` anterior:

Tipo de opciones de ordenación:

- `SORT_REGULAR` - compara los elementos normalmente (sin cambio de tipo)

- `SORT_NUMERIC` - compara los elementos numéricamente

- `SORT_STRING` - compara los elementos como strings

- `SORT_LOCALE_STRING` - compara los elementos como strings, basándose en la configuración local actual. La función utiliza las locales, y estas pueden ser modificadas utilizando la función `setlocale`

- `SORT_NATURAL` - compara los elementos como strings, utilizando el "orden natural", como lo hace la función `natsort`

- `SORT_FLAG_CASE` - puede ser combinado (con el operador OR) con `SORT_STRING` o `SORT_NATURAL` para ordenar los strings sin tener en cuenta la casilla

Este argumento puede ser asociado con el parámetro `array1_sort_order` o simplemente omitido, en cuyo caso, la constante `SORT_REGULAR` será utilizada.

`rest`  
Más argumentos, opcionalmente seguidos por formas de ordenar y flags. Solo los elementos equivalentes en los arrays anteriores son comparados. En otras palabras, el ordenamiento es lexicográfico.

## Valores devueltos

Retorna siempre `true`.

## Historial de cambios

| Versión | Descripción                                                    |
|---------|----------------------------------------------------------------|
| 8.5.0   | El tipo de retorno es ahora `true`; anteriormente, era `bool`. |

## Ejemplos

Ordenar varios arrays

En este ejemplo, después del ordenamiento, el primer array contiene 0, 10, 100, 100. El segundo array contiene 4, 1, 2, 3. Las entradas del segundo array correspondientes a los valores duplicados del primer array (100 y 100), también son ordenadas.

    array(4) {
      [0]=> int(0)
      [1]=> int(10)
      [2]=> int(100)
      [3]=> int(100)
    }
    array(4) {
      [0]=> int(4)
      [1]=> int(1)
      [2]=> int(2)
      [3]=> int(3)
    }

Ordenar un array multidimensional

En este ejemplo, después del ordenamiento, el primer array contiene "10", 100, 100, 11, "a" (orden alfabético, orden ascendente); El segundo array contiene 1, 3, "2", 2, 1 (orden numérico, orden descendente).

    array(2) {
      [0]=> array(5) {
        [0]=> string(2) "10"
        [1]=> int(100)
        [2]=> int(100)
        [3]=> int(11)
        [4]=> string(1) "a"
      }
      [1]=> array(5) {
        [0]=> int(1)
        [1]=> int(3)
        [2]=> string(1) "2"
        [3]=> int(2)
        [4]=> int(1)
      }
    }

Ordenar los resultados de una base de datos

En este ejemplo, cada elemento del array `data` representa una fila de la tabla. Este tipo de datos es típico de un registro de base de datos.

Ejemplo de datos:

    volume | edition
    -------+--------
        67 |       2
        86 |       1
        85 |       6
        98 |       2
        86 |       6
        67 |       7



Los datos están en forma de array, llamado `data`. Esto es generalmente el resultado, por ejemplo, de la función `mysqli_fetch_assoc`.

En este ejemplo, vamos a ordenar la columna `volume` en orden descendente, y la columna `edition` en orden ascendente.

Tenemos un array de filas, pero `array_multisort` requiere un array de columnas, por lo tanto utilizamos el siguiente código para obtener las columnas y así realizar el ordenamiento.

El conjunto de registros ahora está ordenado y se ve así:

    volume | edition
    -------+--------
        98 |       2
        86 |       1
        86 |       6
        85 |       6
        67 |       2
        67 |       7

Ordenamiento no sensible a la casilla

`SORT_STRING` y `SORT_REGULAR` son sensibles a la casilla, los strings que comienzan con una letra mayúscula vendrán antes que los strings que comienzan con una letra minúscula.

Para realizar un ordenamiento no sensible a la casilla, realice el ordenamiento sobre una copia en minúsculas de las columnas del array original.

Array
(
    [0] => Alpha
    [1] => atomic
    [2] => bank
    [3] => Beta
)