جملة switch في PHP: الحالات وbreak والانتقال

تقارن switch ($value) قيمة واحدة بقائمة من وسوم case وتنفّذ الشيفرة تحت أول وسم يطابقها. تنتهي كل حالة بـ break؛ وتعالج default كل ما لم يطابق شيئًا.

<?php
$day = 'sat';

switch ($day) {
    case 'mon':
        echo "Start of the week";
        break;
    case 'fri':
        echo "Almost weekend";
        break;
    case 'sat':
    case 'sun':
        echo "Weekend";
        break;
    default:
        echo "A regular weekday";
}

اضبط $day على 'fri' أو 'sun' أو 'wed' وشغّله مرة أخرى. لا تحتاج حالة default إلى break عندما تكون الأخيرة.

عدة حالات لكتلة واحدة

لتنفيذ الشيفرة نفسها لعدة قيم، ضع وسوم case فوق بعضها دون شيء بينها. الوسم المطابق يستمر إلى الشيفرة التي تحته.

<?php
$extension = 'jpeg';

switch ($extension) {
    case 'jpg':
    case 'jpeg':
    case 'png':
    case 'webp':
        $type = 'image';
        break;
    case 'mp4':
    case 'mov':
        $type = 'video';
        break;
    default:
        $type = 'unknown';
}

echo "Type of .$extension: $type";

على عكس match، ليس في switch صيغة الفاصلة case 'jpg', 'jpeg':. الوسوم المتراصة هي الطريقة الوحيدة.

الانتقال: ماذا يحدث دون break

break هي ما يوقف switch. من دونها، تنفّذ PHP الحالة المطابقة ثم تواصل إلى كل حالة تحتها، متجاهلة وسومها، حتى تصل إلى break أو إلى النهاية.

<?php
$plan = 'pro';

echo "Features for $plan:\n";
switch ($plan) {
    case 'enterprise':
        echo "- single sign-on\n";
    case 'pro':
        echo "- unlimited projects\n";
    case 'free':
        echo "- 3 projects\n";
        echo "- community support\n";
}

الانتقال هنا مقصود: تحصل كل خطة على ميزاتها مع كل ما في الخطط الأرخص. عندما تكتبه عمدًا، أضف تعليقًا مثل // no break حتى لا «يصلحه» القارئ التالي. وعندما لا تقصده، فإن نسيان break من أشهر أخطاء switch.

تستخدم switch المقارنة المرنة (==)

تُفحص كل case بـ == لا ===. النص الرقمي يطابق عددًا، وnull تطابق false و""، وtrue تطابق أي قيمة تُعدّ صحيحة. انقر على الخلايا لتقارن العاملين.

النتيجة العملية: النص "1" القادم من نموذج يقع في case 1: دون أي تحويل، وهذا غالبًا ما تريده. لكن switch (true) مع نص غير فارغ، أو null أمام case false:، قد تختار حالة لم تتوقعها.

<?php
function describe(mixed $value): string
{
    switch ($value) {
        case 0:
            return "zero";
        case "10":
            return "ten";
        case false:
            return "false-ish";
        default:
            return "something else";
    }
}

echo describe("0"), "\n";    // "0" == 0
echo describe(10), "\n";     // 10 == "10"
echo describe("1e1"), "\n";  // "1e1" == "10" (both are numeric)
echo describe(null), "\n";   // null == 0
echo describe(""), "\n";     // "" == false
echo describe("a"), "\n";

لاحظ سطر null: لا يصل أبدًا إلى case false:، لأن null == 0 صحيحة أصلًا وcase 0: تأتي أولًا. مع المقارنة المرنة، يغيّر ترتيب الحالات النتيجة. ومنذ PHP 8، صارت 0 == "a" خاطئة (وكانت صحيحة في PHP 7)، لذا لم يعد النص غير الرقمي يطابق case 0:. إذا احتجت إلى ===، فاستخدم تعبير match، المشروح في آخر هذه الصفحة.

switch(true) للنطاقات والشروط

يمكن أن يكون وسم case أي تعبير. مع switch (true)، تكون كل حالة شرطًا، وتفوز أول حالة تساوي true.

<?php
$score = 83;

switch (true) {
    case $score >= 90:
        $grade = 'A';
        break;
    case $score >= 80:
        $grade = 'B';
        break;
    case $score >= 70:
        $grade = 'C';
        break;
    default:
        $grade = 'F';
}

echo "Score $score is grade $grade";

تأكد أن كل حالة قيمة منطقية حقيقية. بسبب المقارنة المرنة، ستطابق case $name: كلما كانت $name نصًا غير فارغ.

switch داخل حلقة: break وcontinue

داخل حلقة، لا تُخرج break في switch إلا من switch، لا من الحلقة. لإيقاف الحلقة، استخدم break 2. وتتصرف continue داخل switch مثل break، وتحذّر PHP عند الترجمة: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"?. اكتب continue 2 للانتقال إلى التكرار التالي من الحلقة.

<?php
$commands = ['add', 'skip', 'add', 'stop', 'add'];
$total = 0;

foreach ($commands as $command) {
    switch ($command) {
        case 'add':
            $total++;
            break;        // leaves the switch only
        case 'skip':
            continue 2;   // next foreach iteration
        case 'stop':
            break 2;      // leaves the foreach
    }
    echo "after $command, total = $total\n";
}

echo "Final total: $total\n";

switch مقابل match

أضافت PHP 8 التعبير match، الذي يغطي معظم استخدامات switch بشيفرة أقل. يقارن بـ ===، ويعيد قيمة، ولا ينتقل أبدًا إلى الحالة التالية، ويسمح بشروط مفصولة بفواصل، ويرمي UnhandledMatchError عندما لا يتطابق شيء، فلا يمر نسيان حالة بصمت.

<?php
$status = 404;

// switch
switch ($status) {
    case 200:
    case 201:
        $text = 'OK';
        break;
    case 404:
        $text = 'Not found';
        break;
    default:
        $text = 'Error';
}
echo $text, "\n";

// match
echo match ($status) {
    200, 201 => 'OK',
    404 => 'Not found',
    default => 'Error',
}, "\n";

احتفظ بـ switch عندما تحتاج حالة إلى عدة جمل، أو عندما يكون الانتقال هو المقصود، كما في مثال الخطط. ولربط قيمة بنتيجة، match أقصر وأكثر أمانًا.