Fatal error: Uncaught TypeError: Only arrays and Traversables can be unpacked, null given in index.php:7
Ai folosit operatorul ... (spread) pe o valoare care nu e tablou, de obicei null, de exemplu f(...$preturi) când $preturi nu a fost setat. ... merge doar pe tablouri și obiecte parcurgibile. Dă o valoare implicită: f(...($preturi ?? [])), sau verifică datele înainte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Operatorul ... „despachetează” un tablou: f(...[1, 2, 3]) e echivalent cu f(1, 2, 3), iar [...$a, ...$b] lipește două tablouri. Funcționează doar cu tablouri și cu obiecte Traversable (generatoare, ArrayIterator, colecții). Mesajul spune ce tip a primit în loc: null given, string given, int given.
null vine de obicei din:
- o cheie lipsă citită cu
?? nullsau o funcție care întoarcenullcând nu găsește nimic; json_decode()pe un text invalid sau gol;- o proprietate neinițializată cu
[].
Mesajul arată linia cu .... Verifică de unde vine variabila de după ... și ce valoare are când e goală.
De ce apare: cauzele frecvente
1Cheie lipsă din date
<?php
$cos = ['client' => 'Ana'];
$preturi = $cos['preturi'] ?? null;
echo max(...$preturi);<?php
$cos = ['client' => 'Ana'];
$preturi = $cos['preturi'] ?? [];
echo $preturi ? max(...$preturi) : 0;Valoarea implicită trebuie să fie un tablou gol, nu null. max() pe zero argumente ar da altă eroare, de aceea tratăm separat coșul gol.
2Lipire de liste în care una lipsește
<?php
$implicite = ['ro', 'en'];
$extra = json_decode('', true);
$limbi = [...$implicite, ...$extra];<?php
$implicite = ['ro', 'en'];
$extra = json_decode('', true) ?? [];
$limbi = [...$implicite, ...$extra];json_decode('') întoarce null. Cu ?? [] lipirea primește un tablou gol și merge.
3Text dat în loc de tablou
<?php
$etichete = 'php,web';
$toate = [...$etichete, 'nou'];<?php
$etichete = 'php,web';
$toate = [...explode(',', $etichete), 'nou'];Un text nu se poate despacheta. explode() îl transformă întâi în tablou.
Repară eroarea, direct în pagină
Funcția total adună oricâte prețuri, dar programul se oprește la al doilea coș cu Uncaught TypeError: Only arrays and Traversables can be unpacked, null given. Repară citirea prețurilor, ca un coș fără prețuri să aibă totalul 0, iar programul să afișeze Ana: 75 lei și Mihai: 0 lei.
<?php
function total(float ...$preturi): float
{
return array_sum($preturi);
}
$cosuri = [
'Ana' => ['preturi' => [25, 50]],
'Mihai' => [],
];
foreach ($cosuri as $client => $cos) {
$preturi = $cos['preturi'] ?? null;
echo "$client: " . total(...$preturi) . " lei\n";
}Ana: 75 lei Mihai: 0 lei
Indiciu
Valoarea implicită pentru prețurile lipsă trebuie să fie [] în loc de null.
Reparația
<?php
function total(float ...$preturi): float
{
return array_sum($preturi);
}
$cosuri = [
'Ana' => ['preturi' => [25, 50]],
'Mihai' => [],
];
foreach ($cosuri as $client => $cos) {
$preturi = $cos['preturi'] ?? [];
echo "$client: " . total(...$preturi) . " lei\n";
}De ce merge
Coșul lui Mihai nu are cheia preturi, așa că ?? null punea null în $preturi. Operatorul ... nu are ce despacheta dintr-un null și aruncă TypeError.
Cu ?? [], coșul gol devine un tablou gol, total(...[]) e un apel fără argumente, iar array_sum([]) întoarce 0. Funcția variadică float ...$preturi primește oricâte valori, inclusiv niciuna.
Alte forme ale mesajului
Fatal error: Uncaught TypeError: Only arrays and Traversables can be unpacked, string given in index.php:5Fatal error: Uncaught Error: Only arrays and Traversables can be unpacked in index.php:7PHP Fatal error: Uncaught TypeError: Only arrays and Traversables can be unpacked, null given in /var/www/html/index.php:7
Cum o eviți pe viitor
- Inițializează listele cu
[], nu cunull, inclusiv proprietățile din clase (private array $preturi = [];). - Când citești date din exterior (JSON, formulare, API), normalizează-le imediat:
$lista = $date['lista'] ?? [];. - Pune tipuri la parametri (
array $preturi): primești eroarea la intrarea în funcție, cu un mesaj mai clar.
Întrebări frecvente
Pot despacheta un tablou cu chei text?
Da, din PHP 8.1. Într-un apel de funcție, cheile text devin argumente cu nume: f(...['pret' => 10]) e la fel ca f(pret: 10).
Merge ... și pe un generator?
Da, generatoarele sunt Traversable. Atenție doar că un generator se poate parcurge o singură dată.
Erori înrudite
Warning: foreach() argument must be of type array|object, null given in index.php on line 4 Dai lui foreach o valoare care nu e tablou sau obiect, de obicei null (o cheie lipsă sau o funcție care n-a întors nimic). Asigură-te că variabila e un tablou, de exemplu cu foreach ($x ?? [] as ...). Fatal error: Uncaught ValueError: max(): Argument #1 ($value) must contain at least one element in index.php:4 Ai apelat max() sau min() pe un tablou gol, de exemplu după un filtru care n-a găsit nimic. Din PHP 8 asta aruncă ValueError. Verifică înainte dacă tabloul are elemente și tratează separat cazul gol. Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given in index.php:5 Apelezi count() pe o valoare care nu e tablou, de obicei null (o cheie lipsă, o funcție care n-a întors nimic) sau un text. Asigură-te că dai un tablou: count($x ?? []), iar pentru texte folosește strlen(). Î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.
