...
Eroare PHP · Clase și obiecte

Fatal error: Uncaught Error: Cannot modify readonly property Adresa::$oras in index.php:11

Pe scurt

Î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

Greșit
PHP
<?php
class Adresa {
    public function __construct(public readonly string $oras) {}
}
$a = new Adresa('Cluj');
$a->oras = 'Iași';
Corect
PHP
<?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

Greșit
PHP
<?php
class Produs {
    public function __construct(public readonly float $pret) {}
    public function scumpeste(float $p) { $this->pret += $p; }
}
(new Produs(10))->scumpeste(2);
Corect
PHP
<?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

Greșit
PHP
<?php
class Cos {
    public function __construct(public readonly array $produse = []) {}
    public function adauga($p) { $this->produse[] = $p; }
}
Corect
PHP
<?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ă tu

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.

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

Alte forme ale mesajului

  • Fatal error: Uncaught Error: Cannot modify readonly property Produs::$pret in index.php:8
  • Fatal error: Uncaught Error: Cannot initialize readonly property Adresa::$oras from global scope in index.php:11
  • Fatal error: Readonly property Adresa::$oras cannot have default value in index.php on line 3
  • Fatal error: Readonly property Adresa::$oras must have type in index.php on line 3

Cum o eviți pe viitor

  • Folosește readonly pentru 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 private cu metode, nu readonly.

Î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

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