حلقتا while وdo while في PHP: الصيغة والأمثلة

تنفّذ while (condition) { ... } الكتلة مرة بعد مرة ما دام الشرط صحيحًا. يُفحص الشرط قبل كل دورة، فإذا كان خاطئًا من البداية لا يُنفَّذ الجسم أبدًا. لا بد أن يغيّر شيء داخل الحلقة الشرط، وإلا فلن تنتهي.

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

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

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

هذا هو نوع السؤال الذي صُنعت له while: لا تعرف عدد الدورات مسبقًا، بل تعرف متى تتوقف فقط. غيّر نسبة الفائدة وشغّله مرة أخرى.

do while: التنفيذ مرة واحدة على الأقل

تفحص do { ... } while (condition); الشرط بعد الجسم، لذا يُنفَّذ الجسم مرة واحدة دائمًا. لاحظ الفاصلة المنقوطة في النهاية.

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

استخدامها المعتاد هو «جرّب ثم افحص»: ارمِ نردًا حتى تحصل على ستة، وولّد رمزًا حتى تجد رمزًا غير مستخدم. لا بد أن تحدث المحاولة الأولى قبل أن يوجد ما يُفحص. وهذا المثال يعطي نتيجة مختلفة في كل تشغيل:

<?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) مع break

عندما يكون فحص شرط الخروج أسهل في منتصف الجسم، اكتب while (true) واخرج بـ break. وتقفز continue إلى الفحص التالي، كما في أي حلقة.

<?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() القيمة null حين تفرغ المصفوفة، وهذا هو المخرج الآخر. ويمكن كتابة الحلقة نفسها على شكل while ($queue)، لأن المصفوفة الفارغة تُعدّ خاطئة.

قراءة ملف سطرًا سطرًا

تعيد fgets() سطرًا واحدًا في كل مرة وfalse عند نهاية الملف، لذا فهي تقود حلقة while مباشرة. تكتب الكتلة الملف أولًا، ثم تقرؤه.

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

للأقواس حول $line = fgets($handle) أهمية: يحدث الإسناد أولًا، ثم تُقارن النتيجة بـ false. واستخدام !== false بدل فحص بسيط للقيمة المنطقية يمنع سطرًا أخيرًا لا يحمل إلا 0 (دون سطر جديد بعده) من إنهاء الحلقة مبكرًا. تشرح صفحة fopen() دوال الملفات.

while مع endwhile في القوالب

مثل if وfor، لـ while صيغة بالنقطتين لـ HTML: while (...): وendwhile;. يطبع هذا المثال قائمة عدّ تنازلي في تبويب 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>

خطأ شائع: الحلقة التي لا تنتهي

يجب أن يتحرك العداد نحو المخرج. انسَ $i++، أو غيّر المتغير الخطأ، فيبقى الشرط صحيحًا إلى الأبد. على خادم ويب توقف PHP السكربت بعد max_execution_time (30 ثانية افتراضيًا) بخطأ فادح. وفي سطر الأوامر لا يتوقف أبدًا.

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

حدّ الأمان حماية رخيصة للحلقات التي تعتمد على بيانات خارجية، مثل إعادة محاولة استدعاء أو التنقل بين صفحات النتائج:

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

شغّله بضع مرات: ينجح أحيانًا مبكرًا، ويستسلم أحيانًا، لكنه ينتهي دائمًا. وعندما تعرف عدد الدورات مسبقًا، تحدد حلقة for البداية والنهاية والخطوة في سطر واحد، والخطأ فيها أصعب.