...
Eroare PHP · Excepții, JSON și expresii regulate

Fatal error: Uncaught UnhandledMatchError: Unhandled match case 'anulata' in index.php:4

Pe scurt

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

Greșit
PHP
<?php
$status = 'anulata';
echo match ($status) {
    'noua' => 'Comandă nouă',
    'platita' => 'Plătită',
};
Corect
PHP
<?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

Greșit
PHP
<?php
$cod = '404';
echo match ($cod) {
    200 => 'OK',
    404 => 'Negăsit',
};
Corect
PHP
<?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

Greșit
PHP
<?php
$nota = 4;
echo match (true) {
    $nota >= 9 => 'Excelent',
    $nota >= 5 => 'Promovat',
};
Corect
PHP
<?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ă tu

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

Codul care dă eroarea
PHP
<?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";
}
După reparație, programul afișează
Comandă nouă
Plătită
Status necunoscut
Livrată
Indiciu

Brațul default => ... prinde orice valoare care nu se potrivește cu celelalte.

Alte forme ale mesajului

  • Fatal error: Uncaught UnhandledMatchError: Unhandled match case 404 in index.php:4
  • Fatal error: Uncaught UnhandledMatchError: Unhandled match case true in index.php:4
  • Fatal error: Uncaught UnhandledMatchError: Unhandled match case of type Status in index.php:4
  • Fatal error: Uncaught UnhandledMatchError: Unhandled match value of type bool in index.php:4

Cum o eviți pe viitor

  • Pune un braț default ori 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: match pe toate cazurile unui enum e verificat ușor de editor.
  • Lasă match fără default doar 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

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