How can I break an outer loop with PHP?

In PHP, you can break out of an outer loop from within nested loops using the break statement with a numeric parameter or the goto statement. This is useful when you need to exit multiple loop levels at once.

Using break with Numeric Parameter

The break statement accepts an optional numeric parameter that specifies how many nested loops to break out of −

<?php
// Breaking out of nested loops
for ($i = 1; $i <= 3; $i++) {
    echo "Outer loop: $i<br>";
    for ($j = 1; $j <= 3; $j++) {
        echo "  Inner loop: $j<br>";
        if ($i == 2 && $j == 2) {
            echo "  Breaking out of both loops<br>";
            break 2; // Breaks out of both inner and outer loops
        }
    }
}
echo "After loops<br>";
?>

Outer loop: 1
  Inner loop: 1
  Inner loop: 2
  Inner loop: 3
Outer loop: 2
  Inner loop: 1
  Inner loop: 2
  Breaking out of both loops
After loops

Using foreach with break

The same technique works with foreach loops when processing arrays −

<?php
$users = [
    ['name' => 'John', 'age' => 25],
    ['name' => 'Jane', 'age' => 30],
    ['name' => 'Bob', 'age' => 35]
];

$target = 'Jane';

foreach ($users as $user) {
    echo "Checking user: " . $user['name'] . "<br>";
    foreach ($user as $key => $value) {
        echo "  $key: $value<br>";
        if ($value == $target) {
            echo "  Found target user!<br>";
            break 2; // Breaks out of both foreach loops
        }
    }
}
echo "Search complete<br>";
?>

Checking user: John
  name: John
  age: 25
Checking user: Jane
  name: Jane
  Found target user!
Search complete

Using goto Statement

For PHP 5.3 and later, you can use the goto statement as an alternative approach −

<?php
for ($i = 1; $i <= 3; $i++) {
    echo "Outer loop: $i<br>";
    for ($j = 1; $j <= 3; $j++) {
        echo "  Inner loop: $j<br>";
        if ($i == 2 && $j == 1) {
            echo "  Using goto to exit<br>";
            goto endLoops;
        }
    }
}

endLoops:
echo "Jumped to end label<br>";
?>

Outer loop: 1
  Inner loop: 1
  Inner loop: 2
  Inner loop: 3
Outer loop: 2
  Inner loop: 1
  Using goto to exit
Jumped to end label

Comparison

Conclusion

Use break 2 for breaking out of nested loops as it's more readable and widely supported. The goto statement provides more flexibility but should be used sparingly for code maintainability.