Ordena un array según las claves en orden ascendente

# ksort

(PHP 4, PHP 5, PHP 7, PHP 8)

ksort — Ordena un array según las claves en orden ascendente

### Descripción

function ksort(array `&$array`, int `$flags` = `SORT_REGULAR`): true

Ordena `array` en su lugar según las claves en orden ascendente.

> Nota: 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.

> Nota:

> Reinicia el puntero interno del array al primer elemento.

### Parámetros

`array`

  El array de entrada.

`flags`
  El segundo parámetro opcional `flags` puede ser utilizado para modificar el comportamiento de ordenación utilizando estos valores:

  Tipo de banderas de ordenación:

  - `SORT_REGULAR` - compara los elementos normalmente; los detalles son descritos en la sección de los operadores de comparación
  - `SORT_NUMERIC` - compara los elementos numéricamente
  - `SORT_STRING` - compara los elementos como strings
  - `SORT_LOCALE_STRING` - compara los elementos como strings, basado en la configuración regional actual. Esto utiliza la configuración regional, que puede ser cambiada utilizando setlocale()
  - `SORT_NATURAL` - compara los elementos como strings utilizando el "orden natural" como natsort()
  - `SORT_FLAG_CASE` - puede ser combinado (OR a nivel de bits) con `SORT_STRING` o `SORT_NATURAL` para ordenar strings sin tener en cuenta la mayúscula/minúscula

### Valores devueltos

Retorna siempre `true`.

### Historial de cambios

Versión | Descripción
--- | ---
8.2.0 | El tipo de retorno es ahora `true`, anteriormente era bool.
8.2.0 | Esta función realiza ahora una comparación de strings numéricos bajo `SORT_REGULAR` utilizando las reglas estándar de PHP 8.

### Ejemplos

Ejemplo #1 Ejemplo con ksort()

    <?php
    $fruits = array("d"=>"lemon", "a"=>"orange", "b"=>"banana", "c"=>"apple");
    ksort($fruits);
    foreach ($fruits as $key => $val) {
        echo "$key = $val\n";
    }
    ?>

El ejemplo anterior mostrará:

    a = orange
    b = banana
    c = apple
    d = lemon

Ejemplo #2 ksort() con claves int

    <?php
    $a = [0 => 'First', 2 => 'Last', 1 => 'Middle'];
    var_dump($a);
    ksort($a);
    var_dump($a);
    ?>

El ejemplo anterior mostrará:

    array(3) {
      [0]=>
      string(5) "First"
      [2]=>
      string(4) "Last"
      [1]=>
      string(6) "Middle"
    }
    array(3) {
      [0]=>
      string(5) "First"
      [1]=>
      string(6) "Middle"
      [2]=>
      string(4) "Last"
    }

### Ver también

- sort() - Ordena un array en orden creciente
- krsort() - Ordena un array según las claves en orden descendente
- Las funciones de ordenación de arrays

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open