array_shift

array_shift(array &$array): mixed

array_shift modyfikuje tablicę $array bezpośrednio (przez referencję) — usuwa jej pierwszy element i go zwraca. Po usunięciu wszystkie numeryczne klucze są reindeksowane od zera; klucze tekstowe pozostają bez zmian. Jeśli tablica jest pusta, funkcja zwraca null. Razem z array_push tworzy klasyczną kolejkę (FIFO — pierwszy wchodzi, pierwszy wychodzi).

Przydaje się np. gdy obsługujesz listę zadań do wykonania i pobierasz je po jednym od początku.

<?php
declare(strict_types=1);

$kolejka = ['zadanie A', 'zadanie B', 'zadanie C'];
$pierwsze = array_shift($kolejka);
echo $pierwsze . PHP_EOL;
// wynik: zadanie A

print_r($kolejka);
// wynik:
// Array
// (
//     [0] => zadanie B
//     [1] => zadanie C
// )