Fatal error: Uncaught ValueError: "anulata" is not a valid backing value for enum Status in index.php:10
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
<?php
enum Status: string { case Noua = 'noua'; case Platita = 'platita'; }
$s = Status::from('anulata');<?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
<?php
enum Status: string { case Noua = 'noua'; }
$s = Status::from('Noua ');<?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
<?php
enum Prioritate: int { case Mica = 1; case Mare = 3; }
$p = Prioritate::from('Mare');<?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ă 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.
<?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";
}Nouă Plătită Necunoscut
Indiciu
Status::tryFrom() întoarce null pentru valorile necunoscute.
Reparația
<?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::tryFrom($valoare)?->eticheta() ?? 'Necunoscut';
}
foreach (['noua', 'platita', 'anulata'] as $v) {
echo eticheta($v) . "\n";
}De ce merge
Status::from('anulata') caută un caz cu valoarea 'anulata', nu găsește niciunul și aruncă ValueError.
tryFrom() face aceeași căutare, dar întoarce null când nu găsește. Operatorul ?-> apelează eticheta() doar dacă există un caz, altfel dă tot null, iar ?? 'Necunoscut' transformă null în textul afișat.
Alte forme ale mesajului
Fatal error: Uncaught ValueError: "anulata" is not a valid backing value for enum "Status" in index.php:10Fatal error: Uncaught ValueError: 5 is not a valid backing value for enum Prioritate in index.php:10Fatal error: Uncaught TypeError: Prioritate::from(): Argument #1 ($value) must be of type int, string given in index.php:10Fatal 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 cunull(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
Fatal error: Uncaught UnhandledMatchError: Unhandled match case 'anulata' in index.php:4 Expresia match a primit o valoare care nu se potrivește cu niciun braț și nu are default. Adaugă brațul lipsă sau un braț default => ..., care tratează orice altă valoare. Fatal error: Uncaught Exception: Stoc insuficient pentru Rucsac in index.php:6 Codul aruncă o excepție (cu throw) pe care nu o prinde nimeni, așa că scriptul se oprește. Pune apelul care poate eșua într-un try și tratează excepția în catch (de exemplu afișezi mesajul și continui). Fatal error: Uncaught Error: Undefined constant "PRET" in index.php:3 PHP a găsit cuvântul PRET fără $ și fără ghilimele și l-a căutat ca pe o constantă, care nu există. Pune $ dacă e o variabilă, ghilimele dacă e text, sau definește constanta cu const PRET = 10;. Î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.
