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

Warning: foreach() argument must be of type array|object, null given in index.php on line 4

Pe scurt

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ă

Greșit
PHP
<?php
$comanda = ['id' => 7];
foreach ($comanda['produse'] as $p) {
    echo $p;
}
Corect
PHP
<?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

Greșit
PHP
<?php
$etichete = 'php,mysql,html';
foreach ($etichete as $e) {
    echo $e, "\n";
}
Corect
PHP
<?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

Greșit
PHP
<?php
function note($elev) {
    if ($elev === 'Ana') {
        return [9, 10];
    }
}
foreach (note('Dan') as $n) {}
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
    }
}
După reparație, programul afișează
Comanda 101:
- Caiet
- Pix
Comanda 102:
Comanda 103:
- Rucsac
Indiciu

Dă lui foreach un tablou gol când cheia lipsește.

Alte forme ale mesajului

  • Warning: foreach() argument must be of type array|object, string given in index.php on line 4
  • Warning: foreach() argument must be of type array|object, bool given in index.php on line 4
  • Warning: 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, nu null.
  • Pentru date din afară folosește foreach ($x ?? [] as ...).
  • Inițializează listele cu $lista = []; înainte să adaugi în ele.
  • Folosește is_array($x) sau is_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

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