...
Eroare PHP · Excepții, JSON și expresii regulate

Fatal error: Uncaught RuntimeException: Can't shift from an empty datastructure in index.php:7

Pe scurt

Ai apelat dequeue() (sau shift()) pe un SplQueue gol. Coada nu mai are elemente de scos, așa că PHP aruncă RuntimeException. Verifică înainte cu isEmpty() sau parcurge coada cu while (!$coada->isEmpty()).

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

SplQueue e coada din biblioteca standard PHP: adaugi la final cu enqueue() și scoți de la început cu dequeue(). Spre deosebire de array_shift, care pe un tablou gol întoarce null, dequeue() pe o coadă goală aruncă RuntimeException: Can't shift from an empty datastructure.

Surata ei, SplStack, dă Can't pop from an empty datastructure la pop(), iar top() / bottom() pe o structură goală dau Can't peek at an empty datastructure.

Aproape mereu cauza e o buclă care scoate de un număr fix de ori (for până la 3) în loc să se oprească atunci când coada se golește, sau un algoritm (de exemplu BFS) în care condiția buclei nu verifică dacă mai sunt elemente.

De ce apare: cauzele frecvente

1Buclă cu număr fix de pași

Greșit
PHP
<?php
$coada = new SplQueue();
$coada->enqueue('A');
for ($i = 0; $i < 2; $i++) {
    echo $coada->dequeue();
}
Corect
PHP
<?php
$coada = new SplQueue();
$coada->enqueue('A');
while (!$coada->isEmpty()) {
    echo $coada->dequeue();
}

Bucla se oprește exact când coada se golește, indiferent câte elemente a avut.

2Pop pe o stivă goală

Greșit
PHP
<?php
$istoric = new SplStack();
echo $istoric->pop();
Corect
PHP
<?php
$istoric = new SplStack();
echo $istoric->isEmpty() ? 'Nimic de anulat' : $istoric->pop();

Tratezi separat cazul stivei goale.

3Citești vârful fără să verifici

Greșit
PHP
<?php
$s = new SplStack();
echo $s->top();
Corect
PHP
<?php
$s = new SplStack();
if (count($s) > 0) {
    echo $s->top();
}

count() funcționează pe structurile SPL, deci poți verifica înainte.

Repară tu

Repară eroarea, direct în pagină

Programul procesează comenzile dintr-o coadă, dar se oprește la a treia iterație cu RuntimeException: Can't shift from an empty datastructure. Repară bucla ca să proceseze toate comenzile din coadă, oricâte ar fi, și să afișeze Procesez: Comanda 101, Procesez: Comanda 102, apoi Coada e goală.

Codul care dă eroarea
PHP
<?php
$coada = new SplQueue();
$coada->enqueue('Comanda 101');
$coada->enqueue('Comanda 102');

for ($i = 0; $i < 3; $i++) {
    echo 'Procesez: ' . $coada->dequeue() . "\n";
}
echo "Coada e goală\n";
După reparație, programul afișează
Procesez: Comanda 101
Procesez: Comanda 102
Coada e goală
Indiciu

Folosește while (!$coada->isEmpty()) în loc de for.

Alte forme ale mesajului

  • Fatal error: Uncaught RuntimeException: Can't pop from an empty datastructure in index.php:7
  • Fatal error: Uncaught RuntimeException: Can't peek at an empty datastructure in index.php:7
  • Fatal error: Uncaught RuntimeException: Can't peek at an empty heap in index.php:9

Cum o eviți pe viitor

  • Parcurge cozile și stivele cu while (!$s->isEmpty()).
  • În funcții care scot elemente, verifică isEmpty() la început și întoarce null sau aruncă o excepție proprie cu un mesaj clar.
  • La SplPriorityQueue și SplHeap regula e aceeași (valid() sau isEmpty()).
  • Pentru cozi mici, un tablou cu array_shift (care întoarce null) poate fi suficient.

Întrebări frecvente

De ce SplQueue și nu un tablou simplu?

Un tablou merge pentru cozi mici, dar array_shift renumerotează tot tabloul la fiecare scoatere. SplQueue scoate în timp constant, deci e mai bun în algoritmi ca BFS pe date mari.

Pot prinde excepția în loc să verific?

Da, cu catch (RuntimeException $e), dar verificarea isEmpty() e mai clară și mai ieftină.

Erori înrudite

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață PHP de la zero, cu exerciții la fiecare lecție

Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.