PHP array_shift

La función PHP array_shift quitará el primer elemento del array y devolverá su valor. Ten en cuenta que los cambios en el array son hechos en el array original, así pues, cuando llamemos al array ya no tendrá su primer elemento.

array_shift(array &$array): mixed

Vea la descripción y tenga en cuenta que parámetros el array por referencia, &$array lo que quiere decir que esta función trabajara con el array original, de hecho cuando pasamos algo por referencia estamos pasando la dirección de memoria de nuestro array.

$deleted_value = array_shift($array);

Parámetros

$array – array al que deseamos quitarle el primer elemento.

Retornos

mixed – retornará el valor del elemento quitado.

null – en caso de que el array este vacío o $array no sea un array.

Ejemplo

Además del ejemplo que php.net nos proporciona veamos un ejemplo con un array asociativo primero para ver que no hay ninguna diferencia en el uso de la función.

$persona = array(
    "nombre" => "Juan",
    "edad" => 25,
    "ciudad" => "EjemploCity"
);
$value = array_shift($persona);
echo "$value\n";
print_r($persona);

Juan
Array
(
    [edad] => 25
    [ciudad] => EjemploCity
)

Ahora veamos el ejemplo de php.net:

$stack = array("orange", "banana", "apple", "raspberry");
$fruit = array_shift($stack);
print_r($stack);

Array
(
    [0] => banana
    [1] => apple
    [2] => raspberry
)