do-while

(PHP 4, PHP 5, PHP 7)

do-while 循环和 while 循环非常相似,区别在于表达式的值是在每次循环结束时检查而不是开始时。和一般的 while 循环主要的区别是 do-while 的循环语句保证会执行一次(表达式的真值在每次循环结束后检查),然而在一般的 while 循环中就不一定了(表达式真值在循环开始时检查,如果一开始就为 FALSE 则整个循环立即终止)。

do-while 循环只有一种语法:

<?php
$i 
0;
do {
   echo 
$i;
} while (
$i 0);
?>

以上循环将正好运行一次,因为经过第一次循环后,当检查表达式的真值时,其值为 FALSE$i 不大于 0)而导致循环终止。

资深的 C 语言用户可能熟悉另一种不同的 do-while 循环用法,把语句放在 do-while(0) 之中,在循环内部用 break 语句来结束执行循环。以下代码片段示范了此方法:

<?php
do {
    if (
$i 5) {
        echo 
"i is not big enough";
        break;
    }
    
$i *= $factor;
    if (
$i $minimum_limit) {
        break;
    }
    echo 
"i is ok";

    
/* process i */

} while(0);
?>

如果还不能立刻理解也不用担心。即使不用此"特性"也照样可以写出强大的代码来。自 PHP 5.3.0 起,还可以使用 goto 来跳出循环。

User Contributed Notes

M. H. S. 29-Oct-2019 07:02
<!-- if you write with WHILE: -->
<?php
$i
= 100
while ($i < 10) :
    echo
"\$i is $i.";
endwhile;
?>
<!-- returning: -->

<!-- if you write with DO/WHILE: -->
<?php
$i
= 100;
do {
    echo
"\$i is $i.";
} while (
$i < 10);
?>
<!-- returning: -->
$i is 100.
iamjeffjack at gmail dot com 01-Feb-2018 08:26
If you put multiple conditions in the while check, a do-while loop checks these conditions in order and runs again once it encounters a condition that returns true. This can be helpful to know when troubleshooting why a do-while loop isn't finishing. An (illustrative-only) example:

<?php
    $numberOne
= 0;
    do {
        echo
$numberOne;
       
$numberOne++;
    } while(
$numberOne < 5 || incrementNumberTwo() );
    function
incrementNumberTwo() {
        echo
"function incrementNumberTwo called";
        return
false;
    }
   
// outputs "01234function incrementNumberTwo called"
?>
fuhse at data-quest dot de 04-Dec-2016 03:49
What actually surprised me: There is no alternative-syntax or template syntax for a do-while-loop.

So you can write

<?php
while ($a < 10) :
   
$a++;
endwhile;
?>

But this won't work:

<?php
do :
   
$a++
while (
$a <= 10);
?>
jaysherby at gmail dot com 13-Jul-2016 06:12
The last example on this page is simply abuse of the `break` keyword.  Also, the suggestion to use `goto` if you don't understand the abuse of `break` is unsettling.  (See the manual page for `goto` for more than enough reasons not to use it.)

The final example is generally better expressed using a typical if-else statement.

<?php
if ($i < 5) {
    echo
"i is not big enough";
} else {
   
$i *= $factor;

    if (
$i >= $minimum_limit) {
      echo
"i is ok";

     
/* process i */
   
}
}
?>

This version is easier to read and understand.  And arguments for code golf are invalid as well as this version is 3 lines shorter.

In conclusion, although you can certainly write code that abuses the `break` keyword, you shouldn't in practice.  Keep the code easy to read and understand for whoever inherits your code.  And remember, code is for humans not computers.
Martin 28-Apr-2015 03:51
Do-while loops can also be used inside other loops, for example:

<?php
// generating an array with random even numbers between 1 and 1000

$numbers = array();
$array_size = 10;

// for loop runs as long as 2nd condition evaluates to true
for ($i=0;$i<$array_size;$i++) {

     
// always executes (as long as the for-loop runs)
     
do {
        
$random = rand(1,1000);

    
// if the random number is even (condition below is false), the do-while-loop execution ends
     // if it's uneven (condition below is true), the loop continues by generating a new random number
    
} while (($random % 2) == 1);

    
// even random number is written to array and for-loop continues iteration until original condition is met
    
$numbers[] = $random;
}

// sorting array by alphabet

asort($numbers);

// printing array

echo '<pre>';
print_r($numbers);
echo
'</pre>';
?>
shaida dot mca at gmail dot com 18-Aug-2010 11:01
Example of Do while :-

<?php
$i
= 0;
echo
'This code will run at least once because i default value is 0.<br/>';
do {
echo
'i value is ' . $i . ', so code block will run. <br/>';
++
$i;
} while (
$i < 10);
?>
andrew at NOSPAM dot devohive dot com 15-Sep-2008 10:44
I'm guilty of writing constructs without curly braces sometimes... writing the do--while seemed a bit odd without the curly braces ({ and }), but just so everyone is aware of how this is written with a do--while...

a normal while:
<?php
  
while ( $isValid ) $isValid = doSomething($input);
?>

a do--while:
<?php
  
do $isValid = doSomething($input);
   while (
$isValid );
?>

Also, a practical example of when to use a do--while when a simple while just won't do (lol)... copying multiple 2nd level nodes from one document to another using the DOM XML extension

<?php
  
# open up/create the documents and grab the root element
  
$fileDoc  = domxml_open_file('example.xml'); // existing xml we want to copy
  
$fileRoot = $fileDoc->document_element();
  
$newDoc   = domxml_new_doc('1.0'); // new document we want to copy to
  
$newRoot  = $newDoc->create_element('rootnode');
  
$newRoot  = $newDoc->append_child($newRoot); // this is the node we want to copy to

   # loop through nodes and clone (using deep)
  
$child = $fileRoot->first_child(); // first_child must be called once and can only be called once
  
do $newRoot->append_child($child->clone_node(true)); // do first, so that the result from first_child is appended
  
while ( $child = $child->next_sibling() ); // we have to use next_sibling for everything after first_child
?>
jayreardon at gmail dot com 10-Apr-2007 03:36
There is one major difference you should be aware of when using the do--while loop vs. using a simple while loop:  And that is when the check condition is made. 

In a do--while loop, the test condition evaluation is at the end of the loop.  This means that the code inside of the loop will iterate once through before the condition is ever evaluated.  This is ideal for tasks that need to execute once before a test is made to continue, such as test that is dependant upon the results of the loop. 

Conversely, a plain while loop evaluates the test condition at the begining of the loop before any execution in the loop block is ever made. If for some reason your test condition evaluates to false at the very start of the loop, none of the code inside your loop will be executed.