Laço while e do while no PHP: sintaxe e exemplos

while (condition) { ... } executa o bloco de novo e de novo enquanto a condição for verdadeira. A condição é verificada antes de cada volta, então se ela for falsa desde o início, o corpo nunca roda. Algo dentro do loop precisa mudar a condição, ou ele 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);

Esse é o tipo de pergunta para a qual o while foi feito: você não sabe o número de voltas de antemão, só quando parar. Mude a taxa de juros e rode de novo.

do while: rodar pelo menos uma vez

do { ... } while (condition); verifica a condição depois do corpo, então o corpo sempre roda uma vez. Repare no ponto e vírgula no fim.

<?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);

Um uso típico é "tentar e depois verificar": jogar um dado até sair seis, gerar um código até encontrar um não usado. A primeira tentativa precisa acontecer antes de haver algo para verificar. Este dá um resultado diferente a cada execução:

<?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) com break

Quando a condição de saída é mais fácil de verificar no meio do corpo, escreva while (true) e saia com break. continue pula para a próxima verificação, como em qualquer loop.

<?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() retorna null quando o array fica vazio, que é a outra saída. O mesmo loop poderia ser escrito como while ($queue), porque um array vazio conta como falso.

Ler um arquivo linha por linha

fgets() retorna uma linha por vez e false no fim do arquivo, então ele conduz um loop while diretamente. O bloco escreve o arquivo primeiro e depois o lê de volta.

<?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);

Os parênteses em volta de $line = fgets($handle) importam: a atribuição acontece primeiro, depois o resultado é comparado com false. Usar !== false em vez de uma verificação simples de verdadeiro evita que uma última linha contendo só 0 (sem quebra de linha depois) encerre o loop antes da hora. A página sobre fopen() explica as funções de arquivo.

while com endwhile em templates

Como if e for, o while tem uma forma com dois pontos para HTML: while (...): e endwhile;. Este imprime uma lista de contagem regressiva na aba Page.

<?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>

Erro comum: o loop que nunca termina

O contador precisa andar em direção à saída. Esqueça o $i++, ou altere a variável errada, e a condição continua verdadeira para sempre. Num servidor web, o PHP interrompe o script depois do max_execution_time (30 segundos por padrão) com um erro fatal. Na linha de comando ele nunca para.

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

Um limite de segurança é uma proteção barata para loops que dependem de dados externos, como tentar uma chamada de novo ou paginar resultados:

<?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";

Rode algumas vezes: às vezes dá certo cedo, às vezes desiste, mas sempre termina. Quando você sabe o número de voltas de antemão, um laço for informa início, fim e passo numa linha e é mais difícil de errar.