...
Eroare PHP · Funcții și argumente

Fatal error: Uncaught TypeError: array_merge(): Argument #2 must be of type array, null given in index.php:4

Pe scurt

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'] ?? null sau o cheie lipsă;
  • o funcție proprie care întoarce null câ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

Greșit
PHP
<?php
$implicite = ['tema' => 'luminoasa'];
$salvate = json_decode('', true);
$setari = array_merge($implicite, $salvate);
Corect
PHP
<?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

Greșit
PHP
<?php
$filtre = array_merge(['pagina' => 1], $_GET['filtre'] ?? null);
Corect
PHP
<?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

Greșit
PHP
<?php
function produseDinCategorie(string $c): ?array
{
    return null;
}
$toate = array_merge([], produseDinCategorie('carti'));
Corect
PHP
<?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ă tu

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.

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

json_decode întoarce null pentru textul gol; folosește ?? [] ca valoare implicită.

Alte forme ale mesajului

  • Fatal error: Uncaught TypeError: array_merge(): Argument #1 must be of type array, null given in index.php:4
  • Fatal error: Uncaught TypeError: array_merge(): Argument #2 must be of type array, string given in index.php:4
  • Fatal error: Uncaught TypeError: in_array(): Argument #2 ($haystack) must be of type array, null given in index.php:5
  • Warning: 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, nu null sau false.
  • Normalizează datele din exterior imediat după citire: $lista = $date['lista'] ?? [];.
  • Pune tipul array la parametri și la valorile întoarse: eroarea apare mai devreme, unde e cauza.
  • Pentru setări, poți folosi și operatorul +: $salvate + $implicite pă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

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