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()).
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
readonly (din PHP 8.1) înseamnă că proprietatea poate primi valoare o singură dată, din interiorul clasei, de obicei în constructor. Orice încercare ulterioară de a o modifica, inclusiv ++, .= sau adăugarea într-un tablou, aruncă Error: Cannot modify readonly property.
Mesajul apare în două situații: modifici proprietatea din afara clasei ($adresa->oras = 'Iași'), chiar dacă e public, sau o modifici din clasă după ce a fost deja setată (de exemplu într-un setter). Din PHP 8.4 o clasă copil poate inițializa proprietățile readonly ale părintelui, dar tot o singură dată.
Obiectele cu proprietăți readonly sunt gândite ca imutabile: pentru o valoare nouă creezi un obiect nou. Modelul obișnuit este o metodă cuOras() (în engleză withCity()) care întoarce o copie modificată.
De ce apare: cauzele frecvente
1Modificare din afara clasei
<?php
class Adresa {
public function __construct(public readonly string $oras) {}
}
$a = new Adresa('Cluj');
$a->oras = 'Iași';<?php
class Adresa {
public function __construct(public readonly string $oras) {}
}
$a = new Adresa('Cluj');
$a = new Adresa('Iași');Valoarea nouă înseamnă un obiect nou; cel vechi rămâne neschimbat.
2Setter pe o proprietate readonly
<?php
class Produs {
public function __construct(public readonly float $pret) {}
public function scumpeste(float $p) { $this->pret += $p; }
}
(new Produs(10))->scumpeste(2);<?php
class Produs {
public function __construct(public readonly float $pret) {}
public function cuPret(float $p): static { return new static($p); }
}
$nou = (new Produs(10))->cuPret(12);Un obiect imutabil nu se modifică, ci întoarce o copie cu noua valoare.
3Proprietatea chiar trebuie să se schimbe
<?php
class Cos {
public function __construct(public readonly array $produse = []) {}
public function adauga($p) { $this->produse[] = $p; }
}<?php
class Cos {
public function __construct(private array $produse = []) {}
public function adauga($p) { $this->produse[] = $p; }
}Dacă starea se schimbă în mod normal, readonly nu e alegerea potrivită; folosește private cu metode.
Repară eroarea, direct în pagină
Clasa Adresa are proprietăți readonly, dar scriptul încearcă să schimbe orașul unui client care s-a mutat și se oprește cu Error: Cannot modify readonly property Adresa::$oras. Adaugă clasei metoda cuOras(string $oras): Adresa, care întoarce o adresă nouă, și folosește-o, ca programul să afișeze Veche: Str. Lungă 5, Cluj și Nouă: Str. Lungă 5, Iași.
<?php
class Adresa
{
public function __construct(
public readonly string $strada,
public readonly string $oras,
) {}
public function __toString(): string
{
return "{$this->strada}, {$this->oras}";
}
}
$veche = new Adresa('Str. Lungă 5', 'Cluj');
$noua = $veche;
$noua->oras = 'Iași';
echo "Veche: $veche\n";
echo "Nouă: $noua\n";Veche: Str. Lungă 5, Cluj Nouă: Str. Lungă 5, Iași
Indiciu
Metoda creează un obiect nou cu new Adresa(...), păstrând strada și schimbând orașul.
Reparația
<?php
class Adresa
{
public function __construct(
public readonly string $strada,
public readonly string $oras,
) {}
public function cuOras(string $oras): Adresa
{
return new Adresa($this->strada, $oras);
}
public function __toString(): string
{
return "{$this->strada}, {$this->oras}";
}
}
$veche = new Adresa('Str. Lungă 5', 'Cluj');
$noua = $veche->cuOras('Iași');
echo "Veche: $veche\n";
echo "Nouă: $noua\n";De ce merge
Proprietățile readonly primesc valoare o singură dată, în constructor; după aceea orice atribuire aruncă Error. În plus, $noua = $veche; nu copia obiectul, ci doar referința la el, deci chiar dacă modificarea ar fi mers, s-ar fi schimbat și adresa veche.
cuOras() creează un obiect nou cu aceeași stradă și orașul primit. Adresa veche rămâne neatinsă, iar $noua este un obiect separat. Acesta e modelul obiectelor imutabile: nu le modifici, le înlocuiești.
Alte forme ale mesajului
Fatal error: Uncaught Error: Cannot modify readonly property Produs::$pret in index.php:8Fatal error: Uncaught Error: Cannot initialize readonly property Adresa::$oras from global scope in index.php:11Fatal error: Readonly property Adresa::$oras cannot have default value in index.php on line 3Fatal error: Readonly property Adresa::$oras must have type in index.php on line 3
Cum o eviți pe viitor
- Folosește
readonlypentru obiecte-valoare (adrese, sume, date) care nu trebuie să se schimbe după creare. - Setează proprietățile readonly doar în constructor, de preferat prin promovare.
- Pentru modificări, scrie metode
cu...()care întorc un obiect nou. - Dacă obiectul are stare care se schimbă des (coș, cont), folosește
privatecu metode, nureadonly.
Întrebări frecvente
Pot clona un obiect și să-i schimb proprietatea readonly?
Până în PHP 8.3, nu: și clona are proprietatea blocată. Din PHP 8.3 proprietățile readonly pot fi reinițializate în metoda __clone(), dar cel mai simplu e new static(...) cu valorile noi.
Ce e o clasă readonly?
readonly class Adresa { ... } (din PHP 8.2) face toate proprietățile clasei readonly și interzice proprietățile dinamice. E o scurtătură pentru obiectele complet imutabile.
Erori înrudite
Fatal error: Uncaught Error: Typed property Comanda::$client must not be accessed before initialization in index.php:12 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. 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. Deprecated: Creation of dynamic property Produs::$culoare is deprecated in index.php on line 9 Atribui o valoare unei proprietăți care nu e declarată în clasă, iar din PHP 8.2 asta e depreciat. Declară proprietatea în clasă (de exemplu public string $culoare;) sau verifică dacă n-ai scris greșit numele. Î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.
