Оператор switch в PHP: case, break и проваливание

switch ($value) сравнивает одно значение со списком меток case и выполняет код под первой совпавшей меткой. Каждый 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 для одного блока

Чтобы выполнить один и тот же код для нескольких значений, поставьте метки 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 выполняет совпавший case и продолжает выполнять все case ниже, не глядя на их метки, пока не встретит 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:, могут выбрать неожиданный case.

<?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: стоит раньше. При нестрогом сравнении порядок case меняет результат. Начиная с PHP 8, 0 == "a" ложно (в PHP 7 было истинно), поэтому нечисловая строка больше не совпадает с case 0:. Если нужно ===, используйте выражение match, о нём в конце страницы.

switch(true) для диапазонов и условий

Меткой case может быть любое выражение. С switch (true) каждый case это условие, и побеждает первое, которое равно 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 был настоящим логическим значением. Из-за нестрогого сравнения 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, когда ничего не совпало, так что забытый case не пройдёт молча.

<?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, когда в case нужно несколько инструкций или когда проваливание и есть смысл, как в примере с тарифами. Для сопоставления значения с результатом match короче и безопаснее.