Fatal error: Cannot declare promoted property outside a constructor in index.php on line 6
Ai pus public / private / protected / readonly în fața unui parametru dintr-o metodă obișnuită (de ex. setPret(private float $pret)). Promovarea în proprietate merge doar în __construct. În alte metode scrie parametrul simplu și atribuie-l: $this->pret = $pret.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Promovarea în constructor (PHP 8.0) e o prescurtare: public function __construct(private float $pret) {} declară proprietatea $pret și îi atribuie valoarea parametrului, totul dintr-o dată. Cuvântul de vizibilitate (public, private, protected) sau readonly în fața parametrului e cel care face promovarea.
Prescurtarea există doar în constructor, pentru că doar acolo are sens să declari proprietăți la crearea obiectului. Într-o metodă obișnuită (setPret, actualizeaza), în funcții globale sau în closure-uri, un parametru cu private în față e eroare de compilare.
Apare de obicei când copiezi un parametru din constructor într-un setter sau când o metodă statică de tip „fabrică” (creeaza()) primește parametrii scriși ca în constructor. Înrudit: Cannot declare promoted property in an abstract constructor, când constructorul e abstract (sau e în interfață).
De ce apare: cauzele frecvente
1Setter copiat din constructor
<?php
class Produs {
public function __construct(private float $pret) {}
public function setPret(private float $pret): void {}
}<?php
class Produs {
public function __construct(private float $pret) {}
public function setPret(float $pret): void {
$this->pret = $pret;
}
}În setter, parametrul e simplu, iar atribuirea se scrie explicit.
2Metodă fabrică statică
<?php
class Adresa {
public static function creeaza(public string $oras): static {
return new static($oras);
}
}<?php
class Adresa {
public function __construct(public string $oras) {}
public static function creeaza(string $oras): static {
return new static($oras);
}
}Proprietatea se promovează în constructor; metoda fabrică doar îl apelează.
3Constructor abstract
<?php
abstract class Model {
abstract public function __construct(protected int $id);
}<?php
abstract class Model {
public function __construct(protected int $id) {}
}Un constructor abstract n-are corp, deci nici unde să atribuie proprietatea; mesajul e Cannot declare promoted property in an abstract constructor.
Repară eroarea, direct în pagină
Clasa Produs are prețul promovat în constructor și un setter care schimbă prețul, dar fișierul dă Fatal error: Cannot declare promoted property outside a constructor. Repară metoda setPret, ca programul să afișeze Preț: 49.9 și apoi Preț: 39.9.
<?php
class Produs
{
public function __construct(private float $pret) {}
public function setPret(private float $pret): void
{
}
public function pret(): float
{
return $this->pret;
}
}
$p = new Produs(49.9);
echo 'Preț: ' . $p->pret() . "\n";
$p->setPret(39.9);
echo 'Preț: ' . $p->pret() . "\n";Preț: 49.9 Preț: 39.9
Indiciu
În setter scoate private din fața parametrului și atribuie valoarea lui $this->pret.
Reparația
<?php
class Produs
{
public function __construct(private float $pret) {}
public function setPret(float $pret): void
{
$this->pret = $pret;
}
public function pret(): float
{
return $this->pret;
}
}
$p = new Produs(49.9);
echo 'Preț: ' . $p->pret() . "\n";
$p->setPret(39.9);
echo 'Preț: ' . $p->pret() . "\n";De ce merge
private în fața unui parametru înseamnă „declară și atribuie proprietatea”, iar PHP permite asta doar în __construct. În setPret, declarația a fost refuzată la compilare.
Cu un parametru simplu și atribuirea explicită $this->pret = $pret;, setter-ul modifică proprietatea creată de constructor, deci al doilea apel pret() întoarce 39.9.
Alte forme ale mesajului
Fatal error: Cannot declare promoted property in an abstract constructor in index.php on line 3PHP Fatal error: Cannot declare promoted property outside a constructor in /var/www/html/src/Models/Produs.php on line 22
Cum o eviți pe viitor
- Folosește promovarea doar în
__construct; în restul metodelor, parametrii n-au cuvinte de vizibilitate. - Dacă un setter primește aceeași valoare ca un parametru promovat, scrie-l explicit:
$this->pret = $pret;. - Pentru obiecte imutabile, în loc de setter folosește o metodă
cu...()care întoarce o copie.
Întrebări frecvente
Ce face exact promovarea?
public function __construct(private float $pret) {} e echivalent cu: private float $pret; declarat în clasă, plus $this->pret = $pret; în constructor.
Pot combina parametri promovați cu parametri obișnuiți?
Da, în același constructor: __construct(private string $nume, float $pretBrut). Doar cei cu vizibilitate în față devin proprietăți; $pretBrut rămâne doar un parametru.
Erori înrudite
Fatal error: Cannot redeclare Produs::$nume in index.php on line 7 Proprietatea $nume e declarată de două ori în aceeași clasă, aproape mereu o dată sus (private string $nume;) și încă o dată prin promovarea din constructor (__construct(private string $nume)). Păstrează doar una dintre ele: fie ștergi declarația de sus, fie scoți private din parametru și atribui manual. Fatal error: Method Produs::__construct() cannot declare a return type in index.php on line 6 Ai pus un tip de retur la constructor, de obicei : void (public function __construct(): void). Constructorul nu întoarce nimic și nu are voie să declare un tip de retur. Șterge partea : void (sau alt tip) de după parantezele constructorului. 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. Î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.
