break

(PHP 4, PHP 5, PHP 7)

break beendet die Ausführung der aktuellen for-, foreach-, while-, do-while- oder switch-Struktur.

break akzeptiert ein optionales numerisches Argument, das angibt, aus wievielen der es umschließenden verschachtelten Strukturen ausgebrochen werden soll. Der Standardwert ist 1; nur aus der unmittelbar umschließenden Verschachtelung wird ausgebrochen.

<?php
$arr 
= array('eins''zwei''drei''vier''stop''fünf');
while (list(, 
$val) = each($arr)) {
    if (
$val == 'stop') {
        break;    
/* Sie könnten hier auch 'break 1;' schreiben. */
    
}
    echo 
"$val<br />\n";
}

/* Nutzung des optionalen Arguments. */

$i 0;
while (++
$i) {
    switch (
$i) {
    case 
5:
        echo 
"Bei 5<br />\n";
        break 
1;  /* Verlässt nur das switch. */
    
case 10:
        echo 
"Bei 10; brich ab<br />\n";
        break 
2;  /* Verlässt das switch und das while. */
    
default:
        break;
    }
}
?>

Changelog für break
Version Beschreibung
5.4.0 break 0; ist nicht länger gültig. In früheren Versionen wurde es genauso interpretiert wie break 1;.
5.4.0 Die Möglichkeit eine Variable als numerisches Argument zu übergeben (z.B., $num = 2; break $num;) wurde entfernt.

add a note add a note

User Contributed Notes 5 notes

up
129
steve at electricpocket dot com
5 years ago
A break statement that is in the outer part of a program (e.g. not in a control loop) will end the script. This caught me out when I mistakenly had a break in an if statement

i.e.

<?php
echo "hello";
if (
true) break;
echo
" world";
?>

will only show "hello"
up
13
traxer at gmx dot net
11 years ago
vlad at vlad dot neosurge dot net wrote on 04-Jan-2003 04:21

> Just an insignificant side not: Like in C/C++, it's not
> necessary to break out of the default part of a switch
> statement in PHP.

It's not necessary to break out of any case of a switch  statement in PHP, but if you want only one case to be executed, you have do break out of it (even out of the default case).

Consider this:

<?php
$a
= 'Apple';
switch (
$a) {
    default:
        echo
'$a is not an orange<br>';
    case
'Orange':
        echo
'$a is an orange';
}
?>

This prints (in PHP 5.0.4 on MS-Windows):
$a is not an orange
$a is an orange

Note that the PHP documentation does not state the default part must be the last case statement.
up
0
Anonymous
3 months ago
If you are wondering, break and break() are equivalent:

<?php

 
break(2);

  break
2;   //same result

?>
up
1
RK
7 years ago
If the numerical argument is higher than the number of things which can be broken out of, it seems to me like the execution of the entire program is stopped.
My program had 8 nested loops. Didn't bother counting them, but wrote: break 10. - Result: Code following the loops was not processed.
up
-4
Anonymous
10 years ago
If you wonder how to end execution of a function (as I did), it's that simple: return

function foo($a) {
if(!$a) return;
echo 'true';
// some other code
}

foo(true) will echo 'true', foo(false) won't echo anything (as return ends execution of the function. Of course, therefore there is no need for 'else' before 'echo').
To Top