Switch Statement

Documentation Index

Fetch the complete documentation index at: https://docs.syntblaze.com/llms.txt

Use this file to discover all available pages before exploring further.

​

Standard Syntax

switch (expression) {
    case value1:
        // Statements executed if expression == value1
        break;
    case value2:
        // Statements executed if expression == value2
        break;
    default:
        // Statements executed if no cases match
        break;
}

​

Technical Mechanics

• Evaluation and Comparison: The primary expression is evaluated only once at the beginning of the execution block. PHP then compares this result against each case value using loose comparison (==), meaning type coercion may occur (e.g., the integer 1 will match the string "1"). It does not use strict comparison (===).
• Execution Flow (Fallthrough): When a match is found, PHP executes the corresponding statements and continues executing subsequent statements sequentially, ignoring further case labels. This behavior is known as “fallthrough.” To terminate the execution flow and exit the switch block, a break statement must be explicitly declared.
• Stacked Cases: Because of the fallthrough mechanism, multiple case labels can be stacked to execute the same block of code for different values.

switch ($variable) {
    case 1:
    case 2:
    case 3:
        // Executes if $variable is 1, 2, or 3
        break;
}

• The default Case: The default label is optional and acts as a catch-all block. It is selected as the starting point for execution only if no preceding case matches the evaluated expression. While conventionally placed at the end of the switch block, it can technically be positioned anywhere. If placed at the top or middle of the block and triggered as the starting point, execution will fall through into the subsequent case blocks below it unless a break statement is explicitly used. Similarly, preceding cases can fall through into the default block if they lack a break.
• Complex Expressions in Cases: Unlike some languages that restrict case labels to scalar constants, PHP allows expressions within the case statements themselves. If the main switch expression is true, it will match the first case expression that evaluates to a truthy value.
• The continue Quirk: Historically, using the continue statement inside a switch block acted identically to break. However, in PHP 8.0 and later, using continue targeting a switch block results in a compile-time Fatal Error. To skip to the next iteration of an enclosing loop from within a switch, developers must explicitly target the loop using continue 2 (or higher, depending on the nesting level).
• Modern Alternative (match): Because switch uses loose comparison and is inherently prone to fallthrough bugs, the match expression (introduced in PHP 8.0) is the modern alternative. match uses strict comparison (===), does not require break statements (preventing fallthrough), and evaluates to a return value.

​

Alternative Syntax

switch (expression):
    case value1:
        // Statements
        break;
    default:
        // Statements
        break;
endswitch;