PHP array_unshift

La función de PHP array_unshift inserta al inicio del array uno o más elementos.

array_unshift(array &$array, mixed ...$values): int

$narray = array_unshift($array,$value);

Los array numéricos serán modificados para que empiecen desde 0.

Parámetros

$array – el array al que se le agregaran nuevos elementos hacia la izquierda.

$values – los valores que agregaremos

Retorno

int – retorna el número de nuevos elementos en el array

Ejemplos de PHP array_unshift

$persona = array(
    "nombre" => "Juan",
    "edad" => 25,
    "ciudad" => "EjemploCity"
);
array_unshift($persona,"Paraguay");

print_r($persona);

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

Ejemplo con un array numérico:

$numeros = array(10, 20, 30, 40, 50);
array_unshift($numeros,1,2);
print_r($numeros);

Array
(
    [0] => 1
    [1] => 2
    [2] => 10
    [3] => 20
    [4] => 30
    [5] => 40
    [6] => 50
)

Usos

Gestión de Colas (Queues): Si estás implementando una cola de elementos y necesitas insertar nuevos elementos al principio de la cola para que sean procesados primero, array_unshift puede ser útil.

$cola = array();
array_unshift($cola, "Nuevo elemento");

Manejo de Historial o Pila(stack): En situaciones donde estás construyendo un historial o una pila de elementos y deseas agregar nuevos elementos en la parte superior para que sean los más recientes.

$historial = array("Elemento antiguo");
array_unshift($historial, "Nuevo elemento");

Lo normal sería hacer push y pop en una pila pero también podriamos hacer algo como esto si hay elementos que queremos sacar de ultimo.