...
Eroare PHP · Clase și obiecte

Fatal error: Default value for property of type int may not be null. Use the nullable type ?int to allow null default value in index.php on line 4

Pe scurt

Ai declarat o proprietate cu tip (de exemplu public int $stoc = null;), dar ai dat valoarea implicită null, pe care tipul int nu o permite. Fie pui un semn de întrebare la tip (?int $stoc = null), dacă null chiar înseamnă ceva, fie dai o valoare de tipul corect (int $stoc = 0).

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

Ce înseamnă

Din PHP 7.4, proprietățile pot avea tip: public int $stoc;. Tipul int acceptă doar numere întregi; null e un tip separat. Ca să permiți null, scrii tipul nullable ?int (sau int|null). Mesajul îți spune exact asta: valoarea implicită null nu se potrivește cu int, folosește ?int.

Eroarea apare la compilare, pe linia proprietății. Spre deosebire de parametrii funcțiilor, unde int $x = null a fost mult timp acceptat (și acum dă doar un Deprecated), la proprietăți regula a fost strictă de la început.

Întrebarea de pus: „poate lipsi valoarea asta?”. Dacă da (de ex. $dataLivrare pentru o comandă nelivrată), ?DateTimeImmutable $dataLivrare = null e corect. Dacă nu (de ex. stocul), dă o valoare de start reală.

De ce apare: cauzele frecvente

1Contor cu null în loc de 0

Greșit
PHP
<?php
class Produs
{
    public int $stoc = null;
}
Corect
PHP
<?php
class Produs
{
    public int $stoc = 0;
}

Un stoc are mereu o valoare; 0 e o valoare de start reală, iar tipul rămâne strict int.

2Valoare care poate lipsi

Greșit
PHP
<?php
class Comanda
{
    public DateTimeImmutable $livrataLa = null;
}
Corect
PHP
<?php
class Comanda
{
    public ?DateTimeImmutable $livrataLa = null;
}

O comandă nelivrată nu are dată de livrare, deci null are sens. ? spune explicit că e permis.

3Tablou inițializat cu null

Greșit
PHP
<?php
class Cos
{
    private array $produse = null;
}
Corect
PHP
<?php
class Cos
{
    private array $produse = [];
}

Pentru liste, tabloul gol e aproape mereu mai bun decât null: count() și foreach merg fără verificări în plus.

Repară tu

Repară eroarea, direct în pagină

Clasa Comanda are un total care pornește de la 0 și o dată de livrare care poate lipsi, dar fișierul nu pornește: Fatal error: Default value for property of type ... may not be null. Repară cele două proprietăți, ca programul să afișeze Total: 120 lei și Livrare: în curs.

Codul care dă eroarea
PHP
<?php
class Comanda
{
    public float $total = null;
    public string $livrataLa = null;

    public function adauga(float $pret): void
    {
        $this->total += $pret;
    }
}

$c = new Comanda();
$c->adauga(70);
$c->adauga(50);
echo "Total: {$c->total} lei\n";
echo 'Livrare: ' . ($c->livrataLa ?? 'în curs') . "\n";
După reparație, programul afișează
Total: 120 lei
Livrare: în curs
Indiciu

Totalul are mereu o valoare (0), iar data de livrare poate lipsi, deci are nevoie de tipul ?string.

Alte forme ale mesajului

  • Fatal error: Default value for property of type string may not be null. Use the nullable type ?string to allow null default value in index.php on line 4
  • Fatal error: Default value for property of type array may not be null. Use the nullable type ?array to allow null default value in index.php on line 4

Cum o eviți pe viitor

  • Decide pentru fiecare proprietate dacă poate lipsi: dacă nu, dă o valoare implicită reală sau inițializeaz-o în constructor.
  • Folosește ?Tip doar unde null are un sens clar și tratează-l explicit în cod (?->, ??).
  • Listele: array $x = [], nu null.
  • Un analizor static (PHPStan, Psalm) îți arată proprietățile tipizate care pot ajunge null fără să fie declarate așa.

Întrebări frecvente

Pot lăsa proprietatea fără valoare implicită?

Da: public int $stoc; e permis. Doar că proprietatea e „neinițializată” până îi dai o valoare, iar citirea ei înainte dă must not be accessed before initialization.

?int și int|null sunt la fel?

Da, ?int e scrierea scurtă pentru int|null. Pentru tipuri compuse (int|string|null) folosești doar forma cu |.

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.