تعبير match في PHP: match مقابل switch وmatch(true)

يقارن match ($value) { ... } قيمة بقائمة من الأذرع بمقارنة صارمة === ويعيد نتيجة أول ذراع مطابقة. يمكن لعدة قيم أن تتشارك ذراعًا، وتلتقط default الباقي، وإذا لم يتطابق شيء ترمي PHP الخطأ 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;

لاحظ الفاصلة المنقوطة بعد القوس المعقوص الختامي: match تعبير، مثل 1 + 2، لذا فالمجموع كله جملة إسناد واحدة. كل ذراع على شكل values => result، مفصولة بفواصل، ويُسمح بفاصلة زائدة بعد آخر ذراع.

عدة قيم في ذراع واحدة

اكتب القيم مفصولة بفواصل. تتطابق الذراع إذا كانت القيمة المفحوصة مطابقة تمامًا (===) لأي منها.

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

إعادة match مباشرة من دالة، كما هنا، هي الطريقة الأكثر شيوعًا لاستخدامه.

match مقابل switch

الربط نفسه مكتوب بالطريقتين، مع مُدخل واحد يُظهر أكبر فرق: المقارنة. تستخدم switch المقارنة ==، لذا يطابق النص "1" الحالة case 1. ويستخدم match المقارنة ===، فلا يطابقها.

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

استخدم match عندما تحوّل قيمة إلى أخرى. واحتفظ بـ switch عندما يحتاج فرع إلى عدة جمل أو عندما يكون الانتقال هو المقصود؛ صفحة switch تعرض الحالتين.

UnhandledMatchError: عندما لا تتطابق أي ذراع

دون ذراع default، تكون القيمة التي لا تطابق شيئًا خطأً، لا null صامتة. وهذه ميزة: رمز حالة جديد أو خطأ إملائي يفشل بوضوح بدل أن يمر دون أن يُلاحظ.

<?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. وفي إعداد التطوير (مع إيقاف zend.exception_ignore_args) تُذكر القيمة نفسها: Unhandled match case 'XL'. أصلحه إما بإضافة default => 'other'، أو بالتقاط الخطأ حيث تُتوقع قيمة غير معروفة:

<?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) للنطاقات والشروط

يقارن match القيمة المفحوصة بكل ذراع، فإذا كانت القيمة true، أمكن أن تكون كل ذراع شرطًا. ويفوز أول شرط تكون قيمته true تمامًا.

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

تفصيلان في هذه الكتلة. throw تعبير منذ PHP 8، لذا يمكن أن تكون نتيجة ذراع. ولأن المقارنة صارمة، يجب أن يعيد كل شرط قيمة منطقية حقيقية: ذراع مثل $name => ... لا تطابق true أبدًا حتى لو كانت $name نصًا غير فارغ. ولا تُقيَّم إلا الذراع المطابقة، لذا لا تُنفَّذ throw إلا لعمر سالب.

match مع التعدادات

يتلاءم match مع التعدادات: داخل تابع في تعداد، يربط match ($this) كل حالة بقيمة. راجع التعدادات في PHP لمعرفة التعدادات نفسها.

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

لا توجد default هنا عمدًا. إذا أضاف أحدهم حالة خامسة لاحقًا، فإن استدعاء color() عليها يرمي خطأً بدل أن يعيد لونًا خاطئًا.

عدة جمل في ذراع واحدة

تحمل الذراع تعبيرًا واحدًا، لذا فإن 'save' => { ...; ... } ليست PHP صالحة. انقل العمل إلى دالة واستدعها من الذراع. ودوال الأذرع غير المطابقة لا تُستدعى أبدًا.

<?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 إلى 'json' أو 'xml' وشغّله مرة أخرى.