PHP switch case: casos, break e fallthrough

switch ($value) compara um valor com uma lista de rótulos case e executa o código abaixo do primeiro rótulo que bate. Cada case termina com break; default trata tudo o que não bateu com nenhum.

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

Defina $day como 'fri', 'sun' ou 'wed' e rode de novo. O case default não precisa de break quando é o último.

Vários cases para um bloco

Para executar o mesmo código para vários valores, empilhe os rótulos case sem nada entre eles. Um rótulo que bate continua no código abaixo dele.

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

Ao contrário do match, o switch não tem a sintaxe com vírgula case 'jpg', 'jpeg':. Empilhar rótulos é o único jeito.

Fallthrough: o que acontece sem break

O break é o que encerra um switch. Sem ele, o PHP executa o case que bateu e continua por todos os cases abaixo, ignorando os rótulos, até encontrar um break ou o fim.

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

Aqui o fallthrough é proposital: cada plano recebe os próprios recursos mais tudo dos planos mais baratos. Quando você o escrever de propósito, adicione um comentário como // no break para que quem ler depois não o "corrija". Quando não foi a intenção, um break faltando é um dos bugs mais comuns de switch.

O switch usa comparação frouxa (==)

Cada case é verificado com ==, não com ===. Uma string numérica bate com um número, null bate com false e "", e true bate com qualquer valor que conta como verdadeiro. Toque nas células para comparar os dois operadores.

A consequência prática: uma string "1" vinda de um formulário cai em case 1: sem conversão nenhuma, o que muitas vezes é o que você quer. Mas switch (true) com uma string não vazia, ou null encontrando case false:, pode escolher um case inesperado.

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

Repare na linha do null: ele nunca chega a case false:, porque null == 0 já é verdadeiro e case 0: vem antes. Com comparação frouxa, a ordem dos cases muda o resultado. Desde o PHP 8, 0 == "a" é falso (no PHP 7 era verdadeiro), então uma string não numérica não bate mais com case 0:. Se você precisa de ===, use uma expressão match, explicada no fim desta página.

switch(true) para intervalos e condições

Um rótulo case pode ser qualquer expressão. Com switch (true), cada case é uma condição, e a primeira que for igual a true vence.

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

Garanta que cada case seja um booleano de verdade. Por causa da comparação frouxa, case $name: bateria sempre que $name fosse uma string não vazia.

switch dentro de um loop: break e continue

Dentro de um loop, o break num switch só sai do switch, não do loop. Para encerrar o loop, use break 2. continue dentro de um switch se comporta como break, e o PHP avisa em tempo de compilação: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"?. Escreva continue 2 para pular para a próxima iteração do loop.

<?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 ou match

O PHP 8 adicionou o match, que cobre a maioria dos usos do switch com menos código. Ele compara com ===, retorna um valor, nunca cai para o próximo case, aceita condições separadas por vírgula e lança um UnhandledMatchError quando nada bate, então um case esquecido não passa em silêncio.

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

Mantenha o switch quando um case precisa de várias instruções, ou quando o fallthrough é o objetivo, como no exemplo dos planos. Para mapear um valor para um resultado, o match é mais curto e mais seguro.