Boucles while et do while en PHP : syntaxe et exemples

while (condition) { ... } exécute le bloc encore et encore tant que la condition est vraie. La condition est vérifiée avant chaque passage, donc si elle est fausse dès le départ, le corps ne s'exécute jamais. Quelque chose dans la boucle doit modifier la condition, sinon elle ne se termine jamais.

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

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

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

C'est le genre de question pour lequel while est fait : vous ne connaissez pas le nombre de passages à l'avance, seulement quand vous arrêter. Modifiez le taux d'intérêt et relancez.

do while : s'exécuter au moins une fois

do { ... } while (condition); vérifie la condition après le corps, donc le corps s'exécute toujours une fois. Remarquez le point-virgule à la fin.

<?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 usage typique est « essayer, puis vérifier » : lancer un dé jusqu'à obtenir un six, générer un code jusqu'à en trouver un inutilisé. La première tentative doit avoir lieu avant qu'il y ait quoi que ce soit à vérifier. Celui-ci donne un résultat différent à chaque exécution :

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

Quand la condition de sortie est plus facile à vérifier au milieu du corps, écrivez while (true) et sortez avec break. continue passe à la vérification suivante, comme dans toute boucle.

<?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() renvoie null une fois le tableau vide, ce qui est l'autre façon de sortir. La même boucle pourrait s'écrire while ($queue), car un tableau vide compte comme faux.

Lire un fichier ligne par ligne

fgets() renvoie une ligne à la fois et false à la fin du fichier, il pilote donc directement une boucle while. Le bloc écrit d'abord le fichier, puis le relit.

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

Les parenthèses autour de $line = fgets($handle) comptent : l'affectation a lieu d'abord, puis le résultat est comparé à false. Utiliser !== false plutôt qu'un simple test de vérité évite qu'une dernière ligne contenant juste 0 (sans saut de ligne après) termine la boucle trop tôt. La page fopen() couvre les fonctions de fichiers.

while avec endwhile dans les templates

Comme if et for, while a une forme à deux-points pour le HTML : while (...): et endwhile;. Celui-ci affiche une liste de compte à rebours dans l'onglet 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>

Erreur fréquente : la boucle qui ne s'arrête jamais

Le compteur doit se rapprocher de la sortie. Oubliez $i++, ou modifiez la mauvaise variable, et la condition reste vraie pour toujours. Sur un serveur web, PHP arrête le script après max_execution_time (30 secondes par défaut) avec une erreur fatale. En ligne de commande, il ne s'arrête jamais.

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

Une limite de sécurité est une protection peu coûteuse pour les boucles qui dépendent de données extérieures, comme réessayer un appel ou parcourir des pages de résultats :

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

Exécutez-le plusieurs fois : parfois il réussit tôt, parfois il abandonne, mais il se termine toujours. Quand vous connaissez le nombre de passages à l'avance, une boucle for indique le départ, la fin et le pas sur une seule ligne et laisse moins de place à l'erreur.