Fatal error: Uncaught Error: Cannot access private property ContBancar::$sold in index.php:15
Citești sau modifici din afara clasei o proprietate declarată private (sau protected). Folosește o metodă publică a clasei (de exemplu getSold() sau depune()) sau, dacă e cazul, fă proprietatea public readonly.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Vizibilitatea controlează cine poate folosi o proprietate: public de oriunde, protected doar din clasă și din clasele copil, private doar din interiorul clasei care o declară. Când accesezi $cont->sold din afara clasei, iar $sold este private, PHP aruncă Error: Cannot access private property ContBancar::$sold.
Nu e o greșeală a PHP, ci un mecanism voit: încapsularea protejează datele obiectului. Un sold bancar nu ar trebui modificat direct ($cont->sold = 1000000), ci prin metode care verifică regulile (depune(), retrage()).
Același mesaj apare pentru protected (Cannot access protected property) și pentru metode (Call to private method ContBancar::valideaza() from global scope). Din PHP 8.4 există și vizibilitate asimetrică (public private(set)): citești de oriunde, modifici doar din clasă.
De ce apare: cauzele frecvente
1Citire directă din afara clasei
<?php
class Cont {
private float $sold = 100;
}
echo (new Cont)->sold;<?php
class Cont {
private float $sold = 100;
public function getSold(): float { return $this->sold; }
}
echo (new Cont)->getSold();Metoda publică poate citi proprietatea privată, pentru că rulează în interiorul clasei.
2Modificare directă
<?php
class Cont {
private float $sold = 0;
}
$c = new Cont;
$c->sold += 50;<?php
class Cont {
private float $sold = 0;
public function depune(float $s): void {
if ($s > 0) $this->sold += $s;
}
}
$c = new Cont;
$c->depune(50);Modificarea prin metodă permite validarea (aici, doar sume pozitive).
3Proprietate privată folosită în clasa copil
<?php
class Angajat { private float $salariu = 5000; }
class Manager extends Angajat {
function bonus() { return $this->salariu * 0.1; }
}<?php
class Angajat { protected float $salariu = 5000; }
class Manager extends Angajat {
function bonus() { return $this->salariu * 0.1; }
}private nu e vizibil nici în clasele copil. protected permite accesul din moștenitori.
Repară eroarea, direct în pagină
Codul din afara clasei încearcă să retragă bani modificând direct proprietatea privată $sold și se oprește cu Error: Cannot access private property ContBancar::$sold. Adaugă clasei metoda publică retrage(float $suma): void și folosește-o în locul accesului direct, ca programul să afișeze Sold: 300 lei.
<?php
class ContBancar
{
private float $sold = 500;
public function getSold(): float
{
return $this->sold;
}
}
$cont = new ContBancar();
$cont->sold -= 200;
echo "Sold: " . $cont->getSold() . " lei\n";Sold: 300 lei
Indiciu
Metodele clasei au acces la proprietățile private prin $this.
Reparația
<?php
class ContBancar
{
private float $sold = 500;
public function getSold(): float
{
return $this->sold;
}
public function retrage(float $suma): void
{
if ($suma > 0 && $suma <= $this->sold) {
$this->sold -= $suma;
}
}
}
$cont = new ContBancar();
$cont->retrage(200);
echo "Sold: " . $cont->getSold() . " lei\n";De ce merge
$sold este private, deci poate fi citit și modificat doar din metodele clasei ContBancar. Linia $cont->sold -= 200; rulează în afara clasei, așa că PHP o blochează cu Error.
Metoda retrage rulează în interiorul clasei și poate modifica $this->sold. În plus, ea pune regulile într-un singur loc: suma trebuie să fie pozitivă și să nu depășească soldul. Acesta este rostul încapsulării: nimeni din afară nu poate aduce contul într-o stare invalidă.
Alte forme ale mesajului
Fatal error: Uncaught Error: Cannot access protected property Angajat::$salariu in index.php:15Fatal error: Uncaught Error: Call to private method ContBancar::valideaza() from global scope in index.php:15Fatal error: Uncaught Error: Cannot modify private(set) property ContBancar::$sold from global scope in index.php:15Fatal error: Cannot access private property ContBancar::$sold in index.php on line 15
Cum o eviți pe viitor
- Gândește interfața publică a clasei: ce trebuie să poată face codul din afară? Scrie pentru asta metode publice.
- Pentru valori care doar se citesc, folosește
public readonlysau, în PHP 8.4,public private(set). - Folosește
protecteddoar când clasele copil chiar au nevoie de proprietate. - Nu face o proprietate
publicdoar ca să scapi de eroare: pierzi validarea.
Întrebări frecvente
Și dacă fac proprietatea public?
Eroarea dispare, dar oricine poate pune orice valoare (un sold negativ, un preț text). De cele mai multe ori soluția corectă este o metodă publică sau o proprietate readonly.
Ce e public private(set)?
Vizibilitate asimetrică, din PHP 8.4: proprietatea poate fi citită de oriunde (public), dar modificată doar din interiorul clasei (private(set)). E utilă pentru valori pe care obiectul le actualizează singur, ca un sold.
Erori înrudite
Fatal error: Uncaught Error: Call to undefined method Produs::getPret() in index.php:10 Clasa obiectului nu are metoda pe care o apelezi: numele e greșit, metoda e în altă clasă sau ai un obiect de alt tip decât credeai. Verifică numele metodei în clasă (și clasa din mesaj). Fatal error: Uncaught Error: Cannot modify readonly property Adresa::$oras in index.php:11 Încerci să schimbi o proprietate readonly după ce a primit valoarea, sau s-o setezi din afara clasei. O proprietate readonly se setează o singură dată, în clasă. Creează un obiect nou cu valoarea schimbată (de exemplu o metodă cuOras()). Warning: Undefined property: Produs::$pret in index.php on line 9 Obiectul nu are proprietatea pe care o citești: numele e scris greșit sau proprietatea nu e declarată în clasă. Verifică numele exact al proprietății (și majusculele) în definiția clasei. Î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.
