PHP match İfadesi: match ile switch Farkı, match(true)

match ($value) { ... } bir değeri katı === ile bir kol listesiyle karşılaştırır ve eşleşen ilk kolun sonucunu döndürür. Birden çok değer aynı kolu paylaşabilir, default geri kalanları yakalar ve hiçbir şey eşleşmezse PHP bir UnhandledMatchError fırlatır.

<?php
$status = 404;

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

echo $message;

Kapanış süslü parantezinden sonraki noktalı virgüle dikkat edin: match bir ifadedir, tıpkı 1 + 2 gibi, bu yüzden bütünü tek bir atama deyimidir. Her kol values => result biçimindedir, kollar virgülle ayrılır ve son koldan sonra bir virgül bırakmaya izin verilir.

Bir kolda birden çok değer

Değerleri virgülle listeleyin. Konu değeri bunlardan herhangi biriyle özdeşse (===) kol eşleşir.

<?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";
}

Burada olduğu gibi match sonucunu doğrudan bir fonksiyondan döndürmek, onu kullanmanın en yaygın yoludur.

match ile switch karşılaştırması

Aynı eşleme iki şekilde yazılmış, en büyük farkı gösteren bir girdiyle: karşılaştırma. switch == kullanır, bu yüzden "1" dizgesi case 1 ile eşleşir. match === kullanır, bu yüzden eşleşmez.

<?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";

Bir değeri başka bir değere dönüştürürken match kullanın. Bir dal birden çok deyim gerektiriyorsa ya da düşme davranışı zaten amaçsa switch ile devam edin; switch sayfası iki durumu da gösterir.

UnhandledMatchError: hiçbir kol eşleşmediğinde

default kolu yoksa hiçbir şeyle eşleşmeyen bir değer sessiz bir null değil, bir hatadır. Bu bir özelliktir: yeni bir durum kodu veya bir yazım hatası gözden kaçmak yerine açıkça hata verir.

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

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

PHP PHP Fatal error: Uncaught UnhandledMatchError: Unhandled match case of type string ile durur. Bir geliştirme ortamı (zend.exception_ignore_args kapalıyken) bunun yerine değeri adıyla verir: Unhandled match case 'XL'. Bunu ya default => 'other' ekleyerek ya da bilinmeyen bir değerin beklendiği yerde hatayı yakalayarak düzeltin:

<?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";
    }
}

Aralıklar ve koşullar için match(true)

match konu değerini her kolla karşılaştırır; konu değeri true ise her kol bir koşul olabilir. Tam olarak true olarak değerlendirilen ilk koşul kazanır.

<?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";
}

O blokta iki ayrıntı var. throw PHP 8'den beri bir ifadedir, bu yüzden bir kolun sonucu olabilir. Ayrıca karşılaştırma katı olduğu için her koşul gerçek bir boolean döndürmelidir: $name => ... gibi bir kol, $name boş olmayan bir dizge olsa bile true ile asla eşleşmez. Yalnızca eşleşen kol değerlendirilir, bu yüzden throw yalnızca negatif bir yaş için çalışır.

Enum ile match

match ve enum'lar birbirine uyar: bir enum metodu içinde match ($this) her case'i bir değere eşler. Enum'ların kendisi için PHP enum'ları sayfasına bakın.

<?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";
}

Burada default bilerek yok. Biri daha sonra beşinci bir case eklerse, onun üzerinde color() çağırmak yanlış bir renk döndürmek yerine hata fırlatır.

Bir kolda birden çok deyim

Bir kol tek bir ifade tutar, bu yüzden 'save' => { ...; ... } geçerli PHP değildir. İşi bir fonksiyona taşıyın ve koldan çağırın. Eşleşmeyen kolların fonksiyonları asla çağrılmaz.

<?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",
};

$format değerini 'json' veya 'xml' yapın ve tekrar çalıştırın.