...
Eroare PHP · Clase și obiecte

Fatal error: Cannot declare promoted property outside a constructor in index.php on line 6

Pe scurt

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

Greșit
PHP
<?php
class Produs {
    public function __construct(private float $pret) {}
    public function setPret(private float $pret): void {}
}
Corect
PHP
<?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ă

Greșit
PHP
<?php
class Adresa {
    public static function creeaza(public string $oras): static {
        return new static($oras);
    }
}
Corect
PHP
<?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

Greșit
PHP
<?php
abstract class Model {
    abstract public function __construct(protected int $id);
}
Corect
PHP
<?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ă tu

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.

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

În setter scoate private din fața parametrului și atribuie valoarea lui $this->pret.

Alte forme ale mesajului

  • Fatal error: Cannot declare promoted property in an abstract constructor in index.php on line 3
  • PHP 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

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