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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
match (PHP 8) compară valoarea cu fiecare braț folosind comparația strictă ===. Spre deosebire de switch, dacă nicio ramură nu se potrivește și nu există default, nu trece mai departe în tăcere, ci aruncă UnhandledMatchError. Mesajul arată valoarea care n-a fost tratată ('anulata'); pentru valori care nu sunt text sau număr apare doar tipul (Unhandled match case of type Status).
Cauzele tipice: a apărut o valoare nouă pe care n-ai prevăzut-o (un status nou, un cod HTTP), valoarea are alt tip decât brațele ('200' text față de brațul 200 număr; cu === nu se potrivesc), are majuscule sau spații diferite ('Platita', 'platita '), sau ai scris match(true) cu condiții dintre care niciuna nu e adevărată.
Astfel, match te obligă să tratezi toate cazurile, ceea ce e un avantaj.
De ce apare: cauzele frecvente
1Lipsește default
<?php
$status = 'anulata';
echo match ($status) {
'noua' => 'Comandă nouă',
'platita' => 'Plătită',
};<?php
$status = 'anulata';
echo match ($status) {
'noua' => 'Comandă nouă',
'platita' => 'Plătită',
default => 'Status necunoscut',
};default prinde orice valoare netratată de celelalte brațe.
2Tip diferit
<?php
$cod = '404';
echo match ($cod) {
200 => 'OK',
404 => 'Negăsit',
};<?php
$cod = (int) '404';
echo match ($cod) {
200 => 'OK',
404 => 'Negăsit',
};match folosește ===, deci textul '404' nu e egal cu numărul 404. Convertește valoarea înainte.
3match(true) fără ramură pentru restul
<?php
$nota = 4;
echo match (true) {
$nota >= 9 => 'Excelent',
$nota >= 5 => 'Promovat',
};<?php
$nota = 4;
echo match (true) {
$nota >= 9 => 'Excelent',
$nota >= 5 => 'Promovat',
default => 'Nepromovat',
};Pentru intervale, default acoperă valorile sub ultimul prag. Mesajul ar fi Unhandled match case true.
Repară eroarea, direct în pagină
Funcția eticheta transformă statusul unei comenzi într-un text pentru client, dar pentru statusul anulata, care a apărut recent, scriptul se oprește cu UnhandledMatchError: Unhandled match case 'anulata'. Adaugă un braț default, ca programul să afișeze Comandă nouă, Plătită, Status necunoscut și Livrată.
<?php
function eticheta(string $status): string
{
return match ($status) {
'noua' => 'Comandă nouă',
'platita' => 'Plătită',
'livrata' => 'Livrată',
};
}
foreach (['noua', 'platita', 'anulata', 'livrata'] as $s) {
echo eticheta($s) . "\n";
}Comandă nouă Plătită Status necunoscut Livrată
Indiciu
Brațul default => ... prinde orice valoare care nu se potrivește cu celelalte.
Reparația
<?php
function eticheta(string $status): string
{
return match ($status) {
'noua' => 'Comandă nouă',
'platita' => 'Plătită',
'livrata' => 'Livrată',
default => 'Status necunoscut',
};
}
foreach (['noua', 'platita', 'anulata', 'livrata'] as $s) {
echo eticheta($s) . "\n";
}De ce merge
match caută un braț care să fie identic (===) cu valoarea. Pentru anulata nu exista niciunul, iar match nu are voie să întoarcă „nimic”, așa că a aruncat UnhandledMatchError și a oprit bucla.
Brațul default se folosește pentru orice valoare nepotrivită. Brațele se verifică de sus în jos, iar default se aplică doar dacă niciunul nu s-a potrivit, indiferent de poziția lui; de obicei îl scriem ultimul, pentru claritate.
Alte forme ale mesajului
Fatal error: Uncaught UnhandledMatchError: Unhandled match case 404 in index.php:4Fatal error: Uncaught UnhandledMatchError: Unhandled match case true in index.php:4Fatal error: Uncaught UnhandledMatchError: Unhandled match case of type Status in index.php:4Fatal error: Uncaught UnhandledMatchError: Unhandled match value of type bool in index.php:4
Cum o eviți pe viitor
- Pune un braț
defaultori de câte ori valoarea vine din afară (formular, bază de date, API). - Normalizează valoarea înainte de
match:strtolower(trim($status)),(int) $cod. - Pentru seturi fixe de valori, folosește un
enum:matchpe toate cazurile unui enum e verificat ușor de editor. - Lasă
matchfărădefaultdoar când vrei intenționat ca o valoare neașteptată să oprească programul.
Întrebări frecvente
Care e diferența dintre match și switch?
match e o expresie (întoarce o valoare), compară cu ===, nu are nevoie de break și aruncă eroare pentru valorile netratate. switch compară cu == și, fără default, nu face nimic pentru valorile netratate.
Pot pune mai multe valori pe același braț?
Da, despărțite prin virgulă: 'noua', 'in_asteptare' => 'În curs'.
Erori înrudite
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 TypeError: calculeazaReducere(): Return value must be of type float, none returned in index.php:9 Funcția are tip de retur, dar pe una dintre ramuri se termină fără return. Adaugă un return cu valoarea potrivită pe toate ramurile (de obicei la final) sau schimbă tipul în ?float dacă poate întoarce 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.
