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 ...).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
foreach poate parcurge doar tablouri și obiecte. Dacă primește altceva, PHP afișează acest avertisment, sare peste buclă și continuă scriptul. Ultima parte a mesajului spune ce tip a primit: null given, string given, int given, bool given.
Cel mai des e null: citești o cheie care lipsește ($comanda['produse'] când comanda nu are produse), o funcție nu are return pe toate ramurile, sau json_decode a primit un JSON invalid. string given apare când ai un text în loc de listă (de exemplu 'mar,para' nedespărțit cu explode). false given apare la funcțiile care întorc false la eșec.
Caută de unde vine variabila dată lui foreach și verifică cu var_dump() ce conține.
De ce apare: cauzele frecvente
1Cheie lipsă
<?php
$comanda = ['id' => 7];
foreach ($comanda['produse'] as $p) {
echo $p;
}<?php
$comanda = ['id' => 7];
foreach ($comanda['produse'] ?? [] as $p) {
echo $p;
}Cheia lipsă dă null. Cu ?? [] bucla primește un tablou gol și pur și simplu nu se execută.
2Text în loc de tablou
<?php
$etichete = 'php,mysql,html';
foreach ($etichete as $e) {
echo $e, "\n";
}<?php
$etichete = 'php,mysql,html';
foreach (explode(',', $etichete) as $e) {
echo $e, "\n";
}Un text nu se parcurge cu foreach. explode îl împarte într-un tablou.
3Funcție fără return
<?php
function note($elev) {
if ($elev === 'Ana') {
return [9, 10];
}
}
foreach (note('Dan') as $n) {}<?php
function note(string $elev): array {
if ($elev === 'Ana') {
return [9, 10];
}
return [];
}
foreach (note('Dan') as $n) {}Fără return pe ramura falsă, funcția întoarce null. Cu tipul array și un return [] final, rezultatul e întotdeauna un tablou.
Repară eroarea, direct în pagină
Programul afișează produsele din fiecare comandă, dar comanda 102 nu are cheia produse și apare Warning: foreach() argument must be of type array|object, null given. Repară bucla interioară, ca pentru comanda fără produse să nu se afișeze niciun produs și să nu apară avertismente.
<?php
$comenzi = [
['id' => 101, 'produse' => ['Caiet', 'Pix']],
['id' => 102],
['id' => 103, 'produse' => ['Rucsac']],
];
foreach ($comenzi as $c) {
echo "Comanda {$c['id']}:\n";
foreach ($c['produse'] as $p) {
echo "- $p\n";
}
}Comanda 101: - Caiet - Pix Comanda 102: Comanda 103: - Rucsac
Indiciu
Dă lui foreach un tablou gol când cheia lipsește.
Reparația
<?php
$comenzi = [
['id' => 101, 'produse' => ['Caiet', 'Pix']],
['id' => 102],
['id' => 103, 'produse' => ['Rucsac']],
];
foreach ($comenzi as $c) {
echo "Comanda {$c['id']}:\n";
foreach ($c['produse'] ?? [] as $p) {
echo "- $p\n";
}
}De ce merge
Pentru comanda 102, $c['produse'] nu există: întâi apare Undefined array key "produse", iar valoarea null ajunge apoi la foreach, care nu știe să parcurgă null.
$c['produse'] ?? [] înlocuiește cheia lipsă cu un tablou gol, fără avertismente. Un foreach peste un tablou gol nu face nimic, așa că pentru comanda 102 se afișează doar titlul. Același model merge pentru orice listă opțională venită din formular sau din JSON.
Alte forme ale mesajului
Warning: foreach() argument must be of type array|object, string given in index.php on line 4Warning: foreach() argument must be of type array|object, bool given in index.php on line 4Warning: Invalid argument supplied for foreach() in index.php on line 4
Cum o eviți pe viitor
- Dă funcțiilor tip de retur
arrayși întoarce[]când nu ai rezultate, nunull. - Pentru date din afară folosește
foreach ($x ?? [] as ...). - Inițializează listele cu
$lista = [];înainte să adaugi în ele. - Folosește
is_array($x)sauis_iterable($x)înainte de buclă când nu ești sigur de tip.
Întrebări frecvente
În PHP 7 mesajul era Invalid argument supplied for foreach(). E același lucru?
Da. PHP 8 a schimbat textul ca să spună exact ce tip a primit foreach, dar cauza și reparația sunt aceleași.
Scriptul merge mai departe după acest avertisment?
Da, bucla este sărită și execuția continuă. De aceea eroarea e periculoasă: pagina pare să meargă, dar lista apare goală.
Erori înrudite
Warning: Undefined array key "email" in index.php on line 3 Tabloul asociativ nu are cheia "email". Verifică numele cheii sau dă o valoare implicită cu $date['email'] ?? '' ori verifică întâi cu isset() sau array_key_exists(). Fatal error: Uncaught TypeError: calculeazaReducere(): Return value must be of type float, none returned in index.php:9 Funcția are tip de retur, dar pe una dintre ramuri se termină fără return. Adaugă un return cu valoarea potrivită pe toate ramurile (de obicei la final) sau schimbă tipul în ?float dacă poate întoarce null. Warning: Trying to access array offset on null in index.php on line 4 Folosești $x['cheie'] pe o variabilă care este null, nu un tablou. De obicei o funcție de căutare n-a găsit nimic sau o cheie de pe nivelul de mai sus lipsește. Verifică întâi rezultatul (cu ?? sau if) înainte să-l indexezi. Î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.
