...
Eroare PHP · Variabile, constante și tablouri

Fatal error: Uncaught TypeError: Only arrays and Traversables can be unpacked, null given in index.php:7

Pe scurt

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 ?? null sau o funcție care întoarce null câ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

Greșit
PHP
<?php
$cos = ['client' => 'Ana'];
$preturi = $cos['preturi'] ?? null;
echo max(...$preturi);
Corect
PHP
<?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

Greșit
PHP
<?php
$implicite = ['ro', 'en'];
$extra = json_decode('', true);
$limbi = [...$implicite, ...$extra];
Corect
PHP
<?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

Greșit
PHP
<?php
$etichete = 'php,web';
$toate = [...$etichete, 'nou'];
Corect
PHP
<?php
$etichete = 'php,web';
$toate = [...explode(',', $etichete), 'nou'];

Un text nu se poate despacheta. explode() îl transformă întâi în tablou.

Repară tu

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.

Codul care dă eroarea
PHP
<?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";
}
După reparație, programul afișează
Ana: 75 lei
Mihai: 0 lei
Indiciu

Valoarea implicită pentru prețurile lipsă trebuie să fie [] în loc de null.

Alte forme ale mesajului

  • Fatal error: Uncaught TypeError: Only arrays and Traversables can be unpacked, string given in index.php:5
  • Fatal error: Uncaught Error: Only arrays and Traversables can be unpacked in index.php:7
  • PHP 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 cu null, 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

← 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.