...
Eroare PHP · Clase și obiecte

Fatal error: Uncaught ValueError: "anulata" is not a valid backing value for enum Status in index.php:10

Pe scurt

Ai apelat Status::from() cu o valoare care nu corespunde niciunui caz al enum-ului (alt text, alte majuscule, o valoare nouă din baza de date). Folosește Status::tryFrom(), care întoarce null în loc de eroare, și tratează null, sau adaugă cazul lipsă.

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

Ce înseamnă

Un backed enum (enum Status: string { case Noua = 'noua'; ... }) leagă fiecare caz de o valoare simplă, text sau număr. Status::from('noua') face drumul invers: primește valoarea și întoarce cazul. Dacă valoarea nu există printre cazuri, from() aruncă ValueError cu mesajul "anulata" is not a valid backing value for enum Status.

Cauzele tipice: valoarea vine din exterior (bază de date, API, formular) și conține un status nou pe care codul nu-l cunoaște; diferă la majuscule sau spații ('Noua', 'noua '); sau ai dat numele cazului ('Noua') în loc de valoarea lui ('noua'). Pentru numele cazului există constant(Status::class . '::Noua'), nu from().

De ce apare: cauzele frecvente

1Valoare necunoscută venită din exterior

Greșit
PHP
<?php
enum Status: string { case Noua = 'noua'; case Platita = 'platita'; }
$s = Status::from('anulata');
Corect
PHP
<?php
enum Status: string { case Noua = 'noua'; case Platita = 'platita'; }
$s = Status::tryFrom('anulata') ?? Status::Noua;

tryFrom() întoarce null pentru valori necunoscute, iar ?? alege un caz implicit.

2Majuscule sau spații în plus

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

Comparația e exactă. Normalizează textul înainte de from().

3Numele cazului în loc de valoare

Greșit
PHP
<?php
enum Prioritate: int { case Mica = 1; case Mare = 3; }
$p = Prioritate::from('Mare');
Corect
PHP
<?php
enum Prioritate: int { case Mica = 1; case Mare = 3; }
$p = Prioritate::from(3);

from() primește valoarea (3), nu numele ('Mare'). Pentru un enum int, un text nenumeric dă chiar TypeError.

Repară tu

Repară eroarea, direct în pagină

Statusurile comenzilor vin dintr-o bază de date, iar unul dintre ele, anulata, nu există în enum. Scriptul se oprește cu "anulata" is not a valid backing value for enum Status. Repară funcția eticheta ca valorile necunoscute să fie tratate ca Necunoscut, iar programul să afișeze Nouă, Plătită, Necunoscut.

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

    public function eticheta(): string
    {
        return match ($this) {
            Status::Noua => 'Nouă',
            Status::Platita => 'Plătită',
        };
    }
}

function eticheta(string $valoare): string
{
    return Status::from($valoare)->eticheta();
}

foreach (['noua', 'platita', 'anulata'] as $v) {
    echo eticheta($v) . "\n";
}
După reparație, programul afișează
Nouă
Plătită
Necunoscut
Indiciu

Status::tryFrom() întoarce null pentru valorile necunoscute.

Alte forme ale mesajului

  • Fatal error: Uncaught ValueError: "anulata" is not a valid backing value for enum "Status" in index.php:10
  • Fatal error: Uncaught ValueError: 5 is not a valid backing value for enum Prioritate in index.php:10
  • Fatal error: Uncaught TypeError: Prioritate::from(): Argument #1 ($value) must be of type int, string given in index.php:10
  • Fatal error: Uncaught Error: Call to undefined method Status::from() in index.php:10

Cum o eviți pe viitor

  • Pentru date din exterior folosește tryFrom() și decide explicit ce faci cu null (caz implicit, eroare de validare, log).
  • Păstrează from() pentru valori pe care le controlezi și care trebuie să existe.
  • Când adaugi un status nou în baza de date, adaugă-l întâi în enum.
  • from() există doar pe backed enums; un enum pur (enum Status { case Noua; }) dă Call to undefined method Status::from().

Întrebări frecvente

Care e diferența dintre from() și tryFrom()?

Ambele transformă o valoare în caz. Pentru o valoare necunoscută, from() aruncă ValueError, iar tryFrom() întoarce null.

Cum obțin lista valorilor permise?

array_column(Status::cases(), 'value') întoarce toate valorile, util pentru validare sau pentru opțiunile unui <select>.

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.