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

Warning: Trying to access array offset on null in index.php on line 4

Pe scurt

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.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

array offset înseamnă accesul cu paranteze pătrate, $x[...]. Mesajul îți spune că $x nu e tablou, ci null, așa că nu are ce element să-ți dea. PHP întoarce tot null și continuă, dar valoarea pe care o așteptai lipsește.

De obicei variabila e null pentru că: o funcție a întors null (o căutare care n-a găsit elementul, json_decode pe un JSON invalid), o cheie de pe nivelul superior lipsește într-un tablou pe mai multe niveluri ($config['db']['host'] când nu există 'db'), sau variabila nu a fost inițializată.

În versiunile 7.4–8.2 mesajul era Trying to access array offset on value of type null; dacă valoarea e alt tip, vezi on int, on bool (de exemplu false întors de array_search sau strpos).

De ce apare: cauzele frecvente

1Căutare care întoarce null

Greșit
PHP
<?php
function gaseste(array $u, int $id): ?array {
    return $u[$id] ?? null;
}
$user = gaseste([], 7);
echo $user['nume'];
Corect
PHP
<?php
function gaseste(array $u, int $id): ?array {
    return $u[$id] ?? null;
}
$user = gaseste([], 7);
echo $user['nume'] ?? 'utilizator inexistent';

Când utilizatorul nu există, $user e null. Cu ?? tratezi și cazul acesta, fără avertisment.

2Nivel lipsă într-un tablou imbricat

Greșit
PHP
<?php
$config = ['app' => ['nume' => 'Shop']];
echo $config['db']['host'];
Corect
PHP
<?php
$config = ['app' => ['nume' => 'Shop']];
echo $config['db']['host'] ?? 'localhost';

$config['db'] nu există (dă Undefined array key), iar indexarea rezultatului null dă și acest avertisment. ?? acoperă tot lanțul.

3JSON invalid decodat

Greșit
PHP
<?php
$date = json_decode('{nume: "Ana"}', true);
echo $date['nume'];
Corect
PHP
<?php
$date = json_decode('{"nume": "Ana"}', true);
echo $date['nume'];

Cheile JSON trebuie puse în ghilimele duble. Pentru un JSON invalid, json_decode întoarce null.

Repară tu

Repară eroarea, direct în pagină

Funcția gasesteProdus caută un produs după cod și întoarce null dacă nu-l găsește. Pentru codul X9 scriptul afișează Warning: Trying to access array offset on null. Repară bucla, ca pentru produsele inexistente să afișeze X9: produs inexistent, fără avertismente.

Codul care dă eroarea
PHP
<?php
$produse = [
    'A1' => ['nume' => 'Caiet', 'pret' => 7.5],
    'B2' => ['nume' => 'Pix', 'pret' => 2.25],
];

function gasesteProdus(array $produse, string $cod): ?array
{
    return $produse[$cod] ?? null;
}

foreach (['A1', 'X9', 'B2'] as $cod) {
    $p = gasesteProdus($produse, $cod);
    echo "$cod: " . $p['nume'] . " - " . $p['pret'] . " lei\n";
}
După reparație, programul afișează
A1: Caiet - 7.5 lei
X9: produs inexistent
B2: Pix - 2.25 lei
Indiciu

Verifică dacă rezultatul funcției este null înainte să citești ['nume'] și ['pret'].

Alte forme ale mesajului

  • Warning: Trying to access array offset on value of type null in index.php on line 4
  • Warning: Trying to access array offset on false in index.php on line 4
  • Warning: Trying to access array offset on int in index.php on line 4
  • Notice: Trying to access array offset on value of type bool in index.php on line 4

Cum o eviți pe viitor

  • Când o funcție poate întoarce null (tip de retur ?array), verifică rezultatul înainte să-l folosești: if ($user === null) { ... }.
  • Pentru lanțuri de chei folosește ??: $a['x']['y'] ?? 'implicit' nu dă niciun avertisment.
  • Decodează JSON cu JSON_THROW_ON_ERROR, ca un JSON greșit să arunce excepție în loc să întoarcă null în tăcere.

Întrebări frecvente

De ce primesc și Undefined array key, și acest avertisment?

Pentru că sunt două probleme în lanț: întâi cheia de pe primul nivel lipsește (Undefined array key "db"), rezultatul e null, iar apoi indexarea lui null produce Trying to access array offset on null. Rezolvi prima și dispare și a doua.

Pe ce versiune apare 'on null' și pe ce 'on value of type null'?

Mesajul on value of type null a apărut în PHP 7.4, iar versiunile mai noi îl scriu mai scurt, on null. Sensul și reparația sunt aceleași.

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.