switch en PHP: case, break y fallthrough

switch ($value) compara un valor con una lista de etiquetas case y ejecuta el código bajo la primera etiqueta que coincide. Cada case termina con break; default se encarga de todo lo que no coincidió con nada.

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

Pon $day a 'fri', 'sun' o 'wed' y vuelve a ejecutarlo. El case default no necesita break cuando es el último.

Varios case para un bloque

Para ejecutar el mismo código con varios valores, apila las etiquetas case sin nada entre ellas. Una etiqueta que coincide continúa hasta el código de debajo.

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

A diferencia de match, un switch no tiene la sintaxis con comas case 'jpg', 'jpeg':. Apilar etiquetas es la única forma.

Fallthrough: qué pasa sin break

break es lo que detiene un switch. Sin él, PHP ejecuta el case que coincide y sigue con todos los case de debajo, ignorando sus etiquetas, hasta encontrar un break o el final.

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

Aquí el fallthrough es intencionado: cada plan obtiene sus propias funciones más todas las de los planes más baratos. Cuando lo escribas a propósito, añade un comentario como // no break para que quien lea después no lo "arregle". Cuando no era tu intención, un break olvidado es uno de los bugs más comunes de switch.

switch usa comparación flexible (==)

Cada case se comprueba con ==, no con ===. Una cadena numérica coincide con un número, null coincide con false y con "", y true coincide con cualquier valor que cuente como verdadero. Toca las celdas para comparar los dos operadores.

La consecuencia práctica: una cadena "1" que llega de un formulario cae en case 1: sin ninguna conversión, que muchas veces es lo que quieres. Pero switch (true) con una cadena no vacía, o null frente a case false:, pueden elegir un case que no esperabas.

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

Fíjate en la línea de null: nunca llega a case false:, porque null == 0 ya es verdadero y case 0: va antes. Con la comparación flexible, el orden de los case cambia el resultado. Desde PHP 8, 0 == "a" es falso (en PHP 7 era verdadero), así que una cadena no numérica ya no coincide con case 0:. Si necesitas ===, usa una expresión match, explicada al final de esta página.

switch(true) para rangos y condiciones

Una etiqueta case puede ser cualquier expresión. Con switch (true), cada case es una condición, y gana la primera que sea igual a 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";

Asegúrate de que cada case sea un booleano real. Por la comparación flexible, case $name: coincidiría siempre que $name fuera una cadena no vacía.

switch dentro de un bucle: break y continue

Dentro de un bucle, break en un switch solo sale del switch, no del bucle. Para detener el bucle, usa break 2. continue dentro de un switch se comporta como break, y PHP avisa al compilar: "continue" targeting switch is equivalent to "break". Did you mean to use "continue 2"?. Escribe continue 2 para saltar a la siguiente iteración del bucle.

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

PHP 8 añadió match, que cubre la mayoría de los usos de switch con menos código. Compara con ===, devuelve un valor, nunca hace fallthrough, permite condiciones separadas por comas y lanza un UnhandledMatchError cuando nada coincide, así que un case olvidado no puede pasar en silencio.

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

Quédate con switch cuando un case necesita varias sentencias, o cuando el fallthrough es justo lo que buscas, como en el ejemplo de los planes. Para convertir un valor en un resultado, match es más corto y más seguro.