...
Eroare PHP · Clase și obiecte

Fatal error: Uncaught Error: Cannot instantiate enum Status in index.php:8

Pe scurt

Ai încercat să creezi un enum cu new Status('livrata'), ca pe o clasă. Cazurile unui enum există deja și nu se creează. Folosește direct cazul (Status::Livrata) sau, dacă pornești de la o valoare salvată, Status::from('livrata') ori Status::tryFrom('livrata').

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Un enum (PHP 8.1+) seamănă cu o clasă, dar are un număr fix de valori posibile: cazurile declarate. Fiecare caz e un obiect unic, creat de PHP, iar Status::Livrata === Status::Livrata e mereu adevărat. De aceea new nu e permis pe enum-uri: ar crea un obiect care nu e niciunul dintre cazuri.

Mesajul apare la rulare, pe linia cu new. Se întâmplă când transformi o clasă cu constante într-un enum și uiți să schimbi locurile unde se creau obiecte, sau când vii din alte limbaje.

Variante corecte:

  • cazul cunoscut în cod: Status::Livrata;
  • valoarea venită din bază de date / formular (backed enum): Status::from($text) (excepție dacă nu există) sau Status::tryFrom($text) (null dacă nu există);
  • toate cazurile: Status::cases().

De ce apare: cauzele frecvente

1Enum creat cu new din valoarea salvată

Greșit
PHP
<?php
enum Status: string
{
    case Noua = 'noua';
    case Livrata = 'livrata';
}
$s = new Status('livrata');
Corect
PHP
<?php
enum Status: string
{
    case Noua = 'noua';
    case Livrata = 'livrata';
}
$s = Status::from('livrata');

from() caută cazul după valoare și îl întoarce. Nu se creează nimic nou.

2Valoare care poate fi invalidă

Greșit
PHP
<?php
enum Status: string
{
    case Noua = 'noua';
}
$s = new Status($_GET['status'] ?? 'noua');
Corect
PHP
<?php
enum Status: string
{
    case Noua = 'noua';
}
$s = Status::tryFrom($_GET['status'] ?? '') ?? Status::Noua;

tryFrom() întoarce null pentru o valoare necunoscută, iar ?? alege cazul implicit.

3Caz cunoscut în cod

Greșit
PHP
<?php
enum Prioritate { case Mica; case Mare; }
$p = new Prioritate();
Corect
PHP
<?php
enum Prioritate { case Mica; case Mare; }
$p = Prioritate::Mare;

Un pure enum nu are from(); folosești direct cazul.

Repară tu

Repară eroarea, direct în pagină

Funcția eticheta primește statusul unei comenzi ca text, din baza de date, dar programul se oprește cu Uncaught Error: Cannot instantiate enum Status. Repară crearea statusului, ca programul să afișeze Comanda 1: În pregătire și Comanda 2: Livrată.

Codul care dă eroarea
PHP
<?php
enum Status: string
{
    case Noua = 'noua';
    case Livrata = 'livrata';

    public function eticheta(): string
    {
        return match ($this) {
            Status::Noua => 'În pregătire',
            Status::Livrata => 'Livrată',
        };
    }
}

$comenzi = [1 => 'noua', 2 => 'livrata'];
foreach ($comenzi as $id => $text) {
    $status = new Status($text);
    echo "Comanda $id: " . $status->eticheta() . "\n";
}
După reparație, programul afișează
Comanda 1: În pregătire
Comanda 2: Livrată
Indiciu

Un backed enum se obține din valoare cu Status::from($text), nu cu new.

Alte forme ale mesajului

  • Fatal error: Uncaught Error: Cannot instantiate interface Platibil in index.php:8
  • Fatal error: Uncaught Error: Cannot instantiate trait Loggable in index.php:8
  • PHP Fatal error: Uncaught Error: Cannot instantiate enum App\Enums\Status in /var/www/html/src/Comanda.php:21

Cum o eviți pe viitor

  • Când treci de la constante de clasă la enum, caută în proiect toate new NumeEnum și înlocuiește-le cu from() / tryFrom() sau cu cazul direct.
  • Pentru date din exterior folosește tryFrom() și tratează explicit null.
  • Pune tipul enum-ului la parametri (function marcheaza(Status $s)), ca să nu mai circule texte prin cod.

Întrebări frecvente

Pot avea constructor într-un enum?

Nu. Enum-urile nu pot avea constructor, nici proprietăți. Pot avea însă metode și constante, de exemplu public function eticheta(): string.

Care e diferența dintre from și tryFrom?

from() aruncă ValueError dacă valoarea nu corespunde niciunui caz. tryFrom() întoarce null. Folosește from() când valoarea trebuie să fie validă și tryFrom() pentru date de la utilizator.

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.