...
Eroare PHP · Clase și obiecte

Fatal error: Uncaught Error: Typed property Comanda::$client must not be accessed before initialization in index.php:12

Pe scurt

Citești o proprietate cu tip care n-a primit încă nicio valoare (nu are valoare implicită și nici constructorul n-a setat-o). Inițializeaz-o în constructor, dă-i o valoare implicită sau fă-o nullable cu = null.

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

Ce înseamnă

O proprietate fără tip (public $client;) pornește automat cu null. O proprietate cu tip (public string $client;) nu: rămâne într-o stare specială, *uninitialized*, până primește o valoare. Dacă o citești înainte, PHP aruncă Error: Typed property Comanda::$client must not be accessed before initialization.

Situațiile tipice: constructorul nu setează toate proprietățile, ai uitat să apelezi un setter înainte de citire, constructorul clasei copil nu apelează parent::__construct(), sau obiectul a fost creat fără constructor (de unele biblioteci, de PDO::FETCH_CLASS, de deserializare). Pentru proprietățile readonly mesajul e același, pentru că ele nu au voie să aibă valoare implicită.

Mesajul arată clasa și proprietatea; caută unde ar fi trebuit să primească valoare.

De ce apare: cauzele frecvente

1Proprietate nesetată în constructor

Greșit
PHP
<?php
class Comanda {
    public string $status;
}
echo (new Comanda)->status;
Corect
PHP
<?php
class Comanda {
    public string $status = 'nouă';
}
echo (new Comanda)->status;

O valoare implicită inițializează proprietatea la crearea obiectului.

2Valoarea poate lipsi

Greșit
PHP
<?php
class Comanda {
    public string $cupon;
}
$c = new Comanda;
echo $c->cupon ?? 'fără cupon';
Corect
PHP
<?php
class Comanda {
    public ?string $cupon = null;
}
$c = new Comanda;
echo $c->cupon ?? 'fără cupon';

?string cu = null spune explicit că lipsa valorii e normală.

3Lipsește parent::__construct()

Greșit
PHP
<?php
class Angajat {
    protected string $nume;
    function __construct(string $n) { $this->nume = $n; }
}
class Manager extends Angajat {
    function __construct(string $n) {}
    function salut() { return $this->nume; }
}
echo (new Manager('Ana'))->salut();
Corect
PHP
<?php
class Angajat {
    protected string $nume;
    function __construct(string $n) { $this->nume = $n; }
}
class Manager extends Angajat {
    function __construct(string $n) { parent::__construct($n); }
    function salut() { return $this->nume; }
}
echo (new Manager('Ana'))->salut();

Constructorul copil îl înlocuiește pe cel părinte; trebuie să-l apelezi explicit ca să se seteze $nume.

Repară tu

Repară eroarea, direct în pagină

Clasa Comanda declară proprietatea $status cu tip, dar n-o inițializează nicăieri, așa că scriptul se oprește cu Error: Typed property Comanda::$status must not be accessed before initialization. Dă-i valoarea implicită nouă, ca programul să afișeze Comanda 7: nouă și apoi Comanda 7: plătită.

Codul care dă eroarea
PHP
<?php
class Comanda
{
    public string $status;

    public function __construct(public int $id) {}

    public function plateste(): void
    {
        $this->status = 'plătită';
    }
}

$c = new Comanda(7);
echo "Comanda {$c->id}: {$c->status}\n";
$c->plateste();
echo "Comanda {$c->id}: {$c->status}\n";
După reparație, programul afișează
Comanda 7: nouă
Comanda 7: plătită
Indiciu

O proprietate cu tip poate primi o valoare implicită direct în declarație.

Alte forme ale mesajului

  • Fatal error: Uncaught Error: Typed property Comanda::$client must not be accessed before initialization in index.php:12
  • PHP Fatal error: Uncaught Error: Typed property App\Entity\User::$id must not be accessed before initialization in /var/www/html/src/Entity/User.php:20
  • Fatal error: Uncaught Error: Typed static property Config::$instanta must not be accessed before initialization in index.php:7

Cum o eviți pe viitor

  • Inițializează fiecare proprietate cu tip fie cu o valoare implicită, fie în constructor.
  • Folosește proprietăți promovate în constructor: e imposibil să uiți să le setezi.
  • Pentru valori opționale, ?tip $x = null.
  • În clasele copil cu constructor propriu, apelează parent::__construct(...).
  • Verifică inițializarea cu isset($this->x) dacă proprietatea poate fi intenționat goală.

Întrebări frecvente

De ce nu primește automat null, ca proprietățile fără tip?

Pentru că null nu e o valoare validă pentru string. PHP preferă să-ți spună clar că proprietatea nu a fost setată, în loc să-ți dea în tăcere o valoare care încalcă tipul declarat.

Funcționează isset() pe o proprietate neinițializată?

Da, isset($obj->client) întoarce false fără eroare. La fel $obj->client ?? 'implicit'.

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.