array_unshift

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

array_unshift modyfikuje tablicę $array bezpośrednio (przez referencję) — wstawia podane wartości na jej początku i zwraca nową liczbę elementów. Wszystkie istniejące numeryczne klucze są następnie reindeksowane od zera; klucze tekstowe pozostają bez zmian. Elementy są wstawiane w tej samej kolejności, w jakiej podajesz je jako argumenty.

Przydaje się np. gdy chcesz dodać priorytetowy element na czoło listy zadań albo wstawić domyślną opcję na początku menu wyboru.

<?php
declare(strict_types=1);

$lista = ['ser', 'maslo'];
$liczba = array_unshift($lista, 'mleko', 'jajka');
echo $liczba . PHP_EOL;
// wynik: 4

print_r($lista);
// wynik:
// Array
// (
//     [0] => mleko
//     [1] => jajka
//     [2] => ser
//     [3] => maslo
// )