Expression match en PHP : match ou switch, match(true)

match ($value) { ... } compare une valeur à une liste de branches avec le === strict et renvoie le résultat de la première branche qui correspond. Plusieurs valeurs peuvent partager une branche, default attrape le reste, et si rien ne correspond PHP lève une UnhandledMatchError.

<?php
$status = 404;

$message = match ($status) {
    200, 201, 204 => 'Success',
    301, 302 => 'Redirect',
    404 => 'Not found',
    500 => 'Server error',
    default => 'Unknown status',
};

echo $message;

Remarquez le point-virgule après l'accolade fermante : match est une expression, comme 1 + 2, donc l'ensemble forme une seule instruction d'affectation. Chaque branche s'écrit values => result, séparée des autres par une virgule, et une virgule finale après la dernière branche est permise.

Plusieurs valeurs dans une branche

Listez les valeurs séparées par des virgules. La branche correspond si le sujet est identique (===) à l'une d'elles.

<?php
function dayType(string $day): string
{
    return match ($day) {
        'sat', 'sun' => 'weekend',
        'mon', 'tue', 'wed', 'thu', 'fri' => 'weekday',
        default => 'not a day',
    };
}

foreach (['sat', 'wed', 'holiday'] as $d) {
    echo "$d: ", dayType($d), "\n";
}

Renvoyer directement match depuis une fonction, comme ici, est la façon la plus courante de l'utiliser.

match ou switch

La même correspondance écrite des deux façons, avec une entrée qui montre la plus grande différence : la comparaison. switch utilise ==, donc la chaîne "1" correspond à case 1. match utilise ===, donc non.

<?php
$input = "1"; // a string, as it would come from a form

switch ($input) {
    case 1:
        $fromSwitch = 'one';
        break;
    default:
        $fromSwitch = 'other';
}

$fromMatch = match ($input) {
    1 => 'one',
    default => 'other',
};

echo "switch: $fromSwitch\n";
echo "match:  $fromMatch\n";
echo "match after (int): ", match ((int) $input) { 1 => 'one', default => 'other' }, "\n";

Utilisez match quand vous transformez une valeur en une autre. Gardez switch quand une branche a besoin de plusieurs instructions ou quand le passage au cas suivant est le but ; la page switch montre les deux cas.

UnhandledMatchError : quand aucune branche ne correspond

Sans branche default, une valeur qui ne correspond à rien est une erreur, pas un null silencieux. C'est voulu : un nouveau code de statut ou une faute de frappe échoue bruyamment au lieu de passer inaperçu.

<?php
// This throws an UnhandledMatchError on purpose
$size = 'XL';

echo match ($size) {
    'S' => 'small',
    'M' => 'medium',
    'L' => 'large',
};

PHP s'arrête avec PHP Fatal error: Uncaught UnhandledMatchError: Unhandled match case of type string. Une configuration de développement (avec zend.exception_ignore_args désactivé) nomme plutôt la valeur : Unhandled match case 'XL'. Corrigez-le soit en ajoutant default => 'other', soit en interceptant l'erreur là où une valeur inconnue est attendue :

<?php
function sizeName(string $size): string
{
    return match ($size) {
        'S' => 'small',
        'M' => 'medium',
        'L' => 'large',
    };
}

foreach (['M', 'XL'] as $size) {
    try {
        echo sizeName($size), "\n";
    } catch (\UnhandledMatchError $e) {
        echo "Unknown size: $size\n";
    }
}

match(true) pour des plages et des conditions

match compare le sujet à chaque branche, donc si le sujet est true, chaque branche peut être une condition. La première condition qui vaut exactement true l'emporte.

<?php
function ageGroup(int $age): string
{
    return match (true) {
        $age < 0 => throw new InvalidArgumentException('Age cannot be negative'),
        $age < 13 => 'child',
        $age < 18 => 'teenager',
        $age < 65 => 'adult',
        default => 'senior',
    };
}

foreach ([8, 15, 40, 70] as $age) {
    echo "$age: ", ageGroup($age), "\n";
}

try {
    ageGroup(-1);
} catch (InvalidArgumentException $e) {
    echo "Error: ", $e->getMessage(), "\n";
}

Deux détails dans ce bloc. throw est une expression depuis PHP 8, il peut donc être le résultat d'une branche. Et comme la comparaison est stricte, chaque condition doit renvoyer un vrai booléen : une branche comme $name => ... ne correspond jamais à true, même quand $name est une chaîne non vide. Seule la branche qui correspond est évaluée, donc le throw ne s'exécute que pour un âge négatif.

match avec les enums

match et les enums vont bien ensemble : dans une méthode d'enum, match ($this) associe chaque case à une valeur. Voir les enums PHP pour les enums elles-mêmes.

<?php
enum Suit
{
    case Hearts;
    case Diamonds;
    case Clubs;
    case Spades;

    public function color(): string
    {
        return match ($this) {
            Suit::Hearts, Suit::Diamonds => 'Red',
            Suit::Clubs, Suit::Spades => 'Black',
        };
    }
}

foreach (Suit::cases() as $suit) {
    echo $suit->name, " is ", $suit->color(), "\n";
}

Pas de default ici, volontairement. Si quelqu'un ajoute un cinquième case plus tard, appeler color() dessus lève une erreur au lieu de renvoyer une mauvaise couleur.

Plusieurs instructions dans une branche

Une branche contient une seule expression, donc 'save' => { ...; ... } n'est pas du PHP valide. Déplacez le travail dans une fonction et appelez-la depuis la branche. Les fonctions des branches qui ne correspondent pas ne sont jamais appelées.

<?php
function exportCsv(array $rows): string
{
    $lines = array_map(fn($r) => implode(',', $r), $rows);
    return implode("\n", $lines);
}

function exportJson(array $rows): string
{
    return json_encode($rows);
}

$rows = [['Ada', 36], ['Linus', 28]];
$format = 'csv';

echo match ($format) {
    'csv' => exportCsv($rows),
    'json' => exportJson($rows),
    default => "Unsupported format: $format",
};

Mettez $format à 'json' ou 'xml' et relancez.