Fatal error: Uncaught TypeError: array_merge(): Argument #2 must be of type array, null given in index.php:4
Unul dintre tablourile date lui array_merge() e de fapt null (sau alt tip), de obicei rezultatul unui json_decode eșuat, al unei chei lipsă sau al unei funcții care n-a găsit nimic. Din PHP 8 asta e eroare fatală. Dă o valoare implicită cu ?? [] sau verifică datele înainte.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
array_merge() lipește mai multe tablouri. Toate argumentele trebuie să fie tablouri; mesajul spune exact care nu e: Argument #2 e al doilea, iar null given spune ce ai trimis. În PHP 7, aceeași greșeală dădea doar un warning și funcția întorcea null; din PHP 8 e TypeError și scriptul se oprește.
De unde vine null:
json_decode()pe un text gol sau invalid (de ex. un fișier de configurare lipsă sau stricat);$_POST['filtre'] ?? nullsau o cheie lipsă;- o funcție proprie care întoarce
nullcând nu găsește nimic; $x = $x + ...sau alt cod care a suprascris tabloul cu altceva.
Același tip de mesaj apare și la in_array(), array_keys(), array_key_exists() sau implode(): e mereu „ai dat altceva decât un tablou”.
De ce apare: cauzele frecvente
1JSON gol sau invalid
<?php
$implicite = ['tema' => 'luminoasa'];
$salvate = json_decode('', true);
$setari = array_merge($implicite, $salvate);<?php
$implicite = ['tema' => 'luminoasa'];
$salvate = json_decode('', true) ?? [];
$setari = array_merge($implicite, $salvate);json_decode întoarce null când nu poate citi textul. ?? [] îl transformă în tablou gol.
2Cheie lipsă din formular
<?php
$filtre = array_merge(['pagina' => 1], $_GET['filtre'] ?? null);<?php
$filtre = array_merge(['pagina' => 1], (array) ($_GET['filtre'] ?? []));Valoarea implicită trebuie să fie un tablou. (array) acoperă și cazul în care utilizatorul trimite un singur text.
3Funcție care întoarce null
<?php
function produseDinCategorie(string $c): ?array
{
return null;
}
$toate = array_merge([], produseDinCategorie('carti'));<?php
function produseDinCategorie(string $c): array
{
return [];
}
$toate = array_merge([], produseDinCategorie('carti'));Pentru „nimic găsit” o listă goală e mai sigură decât null: toate funcțiile de tablouri o acceptă.
Repară eroarea, direct în pagină
Funcția setari combină setările implicite cu cele salvate de utilizator (în JSON), dar la al doilea utilizator programul se oprește cu Uncaught TypeError: array_merge(): Argument #2 must be of type array, null given. Repară funcția, ca un JSON gol sau invalid să însemne „fără setări salvate”, iar programul să afișeze Ana: întunecată, ro și Mihai: luminoasă, ro.
<?php
function setari(string $json): array
{
$implicite = ['tema' => 'luminoasă', 'limba' => 'ro'];
$salvate = json_decode($json, true);
return array_merge($implicite, $salvate);
}
foreach (['Ana' => '{"tema": "întunecată"}', 'Mihai' => ''] as $nume => $json) {
$s = setari($json);
echo "$nume: {$s['tema']}, {$s['limba']}\n";
}Ana: întunecată, ro Mihai: luminoasă, ro
Indiciu
json_decode întoarce null pentru textul gol; folosește ?? [] ca valoare implicită.
Reparația
<?php
function setari(string $json): array
{
$implicite = ['tema' => 'luminoasă', 'limba' => 'ro'];
$salvate = json_decode($json, true) ?? [];
return array_merge($implicite, $salvate);
}
foreach (['Ana' => '{"tema": "întunecată"}', 'Mihai' => ''] as $nume => $json) {
$s = setari($json);
echo "$nume: {$s['tema']}, {$s['limba']}\n";
}De ce merge
Pentru Mihai, JSON-ul e gol, iar json_decode('') întoarce null. array_merge() acceptă doar tablouri, așa că PHP 8 a aruncat TypeError pentru al doilea argument.
Cu ?? [], lipsa setărilor devine un tablou gol, iar array_merge întoarce doar valorile implicite. Pentru Ana, valoarea salvată tema o suprascrie pe cea implicită, iar limba rămâne cea implicită.
Alte forme ale mesajului
Fatal error: Uncaught TypeError: array_merge(): Argument #1 must be of type array, null given in index.php:4Fatal error: Uncaught TypeError: array_merge(): Argument #2 must be of type array, string given in index.php:4Fatal error: Uncaught TypeError: in_array(): Argument #2 ($haystack) must be of type array, null given in index.php:5Warning: array_merge(): Expected parameter 2 to be an array, null given in index.php on line 4
Cum o eviți pe viitor
- Funcțiile care întorc liste să întoarcă
[]când nu găsesc nimic, nunullsaufalse. - Normalizează datele din exterior imediat după citire:
$lista = $date['lista'] ?? [];. - Pune tipul
arrayla parametri și la valorile întoarse: eroarea apare mai devreme, unde e cauza. - Pentru setări, poți folosi și operatorul
+:$salvate + $implicitepăstrează valorile salvate și completează ce lipsește.
Întrebări frecvente
De ce în PHP 7 mergea?
În PHP 7, array_merge() cu null afișa doar un warning și întorcea null, iar codul mergea mai departe cu date greșite. PHP 8 a transformat aceste cazuri în TypeError, ca greșeala să fie vizibilă imediat.
Care e diferența dintre array_merge și +?
array_merge suprascrie cheile text cu valorile din tablourile de mai la dreapta și renumerotează cheile numerice. + păstrează valorile din primul tablou și adaugă doar cheile care lipsesc.
Erori înrudite
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(). 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 JsonException: Syntax error in index.php:4 Textul dat lui json_decode (cu JSON_THROW_ON_ERROR) nu e JSON valid: ghilimele simple, chei fără ghilimele, virgulă după ultimul element sau text gol. Corectează JSON-ul sau prinde JsonException și tratează datele invalide. 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. Î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.
