Bucle while y do while en PHP: sintaxis y ejemplos

while (condition) { ... } ejecuta el bloque una y otra vez mientras la condición sea verdadera. La condición se comprueba antes de cada vuelta, así que si es falsa desde el principio, el cuerpo no se ejecuta nunca. Algo dentro del bucle tiene que cambiar la condición, o nunca termina.

<?php
$balance = 1000;
$year = 0;

while ($balance < 2000) {
    $balance *= 1.07;   // 7% interest per year
    $year++;
}

echo "Doubled after $year years: ", round($balance, 2);

Este es el tipo de pregunta para el que existe while: no sabes de antemano el número de vueltas, solo cuándo parar. Cambia el tipo de interés y vuelve a ejecutarlo.

do while: ejecutar al menos una vez

do { ... } while (condition); comprueba la condición después del cuerpo, así que el cuerpo siempre se ejecuta una vez. Fíjate en el punto y coma del final.

<?php
$i = 10;

while ($i < 5) {
    echo "while: $i\n";   // never runs
    $i++;
}

$i = 10;
do {
    echo "do while: $i\n"; // runs once
    $i++;
} while ($i < 5);

Un uso típico es "intentar y luego comprobar": tirar un dado hasta sacar un seis, generar un código hasta que no esté en uso. El primer intento tiene que ocurrir antes de que haya algo que comprobar. Este da un resultado distinto en cada ejecución:

<?php
$rolls = 0;

do {
    $roll = random_int(1, 6);
    $rolls++;
    echo "Roll $rolls: $roll\n";
} while ($roll !== 6);

echo "Got a six after $rolls rolls\n";

while (true) con break

Cuando la condición de salida es más fácil de comprobar en mitad del cuerpo, escribe while (true) y sal con break. continue salta a la siguiente comprobación, como en cualquier bucle.

<?php
$queue = ['email:ada', 'skip', 'email:linus', 'stop', 'email:grace'];

while (true) {
    $job = array_shift($queue);   // take the first item

    if ($job === null) {
        echo "Queue empty\n";
        break;
    }
    if ($job === 'skip') {
        continue;
    }
    if ($job === 'stop') {
        echo "Stop signal, ", count($queue), " job(s) left\n";
        break;
    }

    echo "Processing $job\n";
}

array_shift() devuelve null cuando el array está vacío, que es la otra forma de salir. El mismo bucle se podría escribir como while ($queue), porque un array vacío cuenta como falso.

Leer un archivo línea a línea

fgets() devuelve una línea cada vez y false al final del archivo, así que dirige directamente un bucle while. El bloque escribe primero el archivo y luego lo vuelve a leer.

<?php
file_put_contents('visits.log', "2026-03-01 home\n2026-03-01 pricing\n2026-03-02 home\n");

$handle = fopen('visits.log', 'r');
$count = 0;

while (($line = fgets($handle)) !== false) {
    $count++;
    [$date, $page] = explode(' ', trim($line));
    echo "$count: $page on $date\n";
}

fclose($handle);

Los paréntesis alrededor de $line = fgets($handle) importan: primero se hace la asignación y luego se compara el resultado con false. Usar !== false en lugar de una simple comprobación de verdad evita que una última línea que contenga solo 0 (sin salto de línea detrás) termine el bucle antes de tiempo. La página de fopen() explica las funciones de archivos.

while con endwhile en plantillas

Igual que if y for, while tiene una forma con dos puntos para HTML: while (...): y endwhile;. Esta imprime una lista de cuenta atrás en la pestaña Página.

<?php
$n = 5;
?>
<ol reversed>
<?php while ($n > 0): ?>
    <li><?= $n ?> second<?= $n === 1 ? '' : 's' ?> left</li>
    <?php $n--; ?>
<?php endwhile; ?>
</ol>
<p>Done.</p>

Error frecuente: el bucle que nunca termina

El contador tiene que avanzar hacia la salida. Olvida $i++, o cambia la variable equivocada, y la condición sigue siendo verdadera para siempre. En un servidor web, PHP detiene el script tras max_execution_time (30 segundos por defecto) con un error fatal. En la línea de comandos no se detiene nunca.

// Never ends: $i is never changed
$i = 0;
while ($i < 3) {
    echo $i;
}

Un límite de seguridad es una protección barata para los bucles que dependen de datos externos, como reintentar una llamada o recorrer resultados página a página:

<?php
$attempt = 0;
$maxAttempts = 5;
$success = false;

while (!$success && $attempt < $maxAttempts) {
    $attempt++;
    $success = random_int(1, 4) === 1;   // pretend this is a network call
    echo "Attempt $attempt: ", $success ? "ok" : "failed", "\n";
}

echo $success ? "Done\n" : "Gave up after $maxAttempts attempts\n";

Ejecútalo varias veces: unas veces funciona pronto, otras se rinde, pero siempre termina. Cuando conoces de antemano el número de vueltas, un bucle for indica el inicio, el final y el paso en una línea y es más difícil equivocarse.