...
Eroare PHP · Clase și obiecte

Fatal error: Uncaught Error: Cannot access private property ContBancar::$sold in index.php:15

Pe scurt

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

Greșit
PHP
<?php
class Cont {
    private float $sold = 100;
}
echo (new Cont)->sold;
Corect
PHP
<?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ă

Greșit
PHP
<?php
class Cont {
    private float $sold = 0;
}
$c = new Cont;
$c->sold += 50;
Corect
PHP
<?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

Greșit
PHP
<?php
class Angajat { private float $salariu = 5000; }
class Manager extends Angajat {
    function bonus() { return $this->salariu * 0.1; }
}
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Sold: 300 lei
Indiciu

Metodele clasei au acces la proprietățile private prin $this.

Alte forme ale mesajului

  • Fatal error: Uncaught Error: Cannot access protected property Angajat::$salariu in index.php:15
  • Fatal error: Uncaught Error: Call to private method ContBancar::valideaza() from global scope in index.php:15
  • Fatal error: Uncaught Error: Cannot modify private(set) property ContBancar::$sold from global scope in index.php:15
  • Fatal 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 readonly sau, în PHP 8.4, public private(set).
  • Folosește protected doar când clasele copil chiar au nevoie de proprietate.
  • Nu face o proprietate public doar 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

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