حلقة foreach في PHP: المفتاح والقيمة والفهرس والمرجع

تنفّذ foreach ($array as $value) الكتلة مرة لكل عنصر، مع ضبط $value على العنصر الحالي. وللحصول على المفتاح أيضًا، اكتب foreach ($array as $key => $value).

<?php
$colors = ['red', 'green', 'blue'];

foreach ($colors as $color) {
    echo $color, "\n";
}

$ages = ['Ada' => 36, 'Linus' => 28, 'Grace' => 45];

foreach ($ages as $name => $age) {
    echo "$name is $age\n";
}

تعمل foreach على أي مصفوفة، أيًّا كانت مفاتيحها، ولا تدير فيها عدادًا ولا تفحص طولًا. إنها الحلقة التي ستكتبها أكثر من غيرها في PHP.

المرور على المفاتيح والقيم

في $key => $value، الأسماء من اختيارك: $name => $age أو $id => $user أو $k => $v. في القائمة، المفاتيح هي المواضع 0, 1, 2. وفي المصفوفة الترابطية، هي المفاتيح النصية التي عرّفتها.

<?php
$config = [
    'host' => 'localhost',
    'port' => 8080,
    'debug' => true,
];

foreach ($config as $key => $value) {
    printf("%-6s = %s\n", $key, var_export($value, true));
}

// Only the keys
foreach (array_keys($config) as $key) {
    echo "key: $key\n";
}

// Keys like "1" become integers
$codes = ["1" => 'one', "01" => 'zero one'];
foreach ($codes as $key => $value) {
    echo gettype($key), " key ", var_export($key, true), " => $value\n";
}

تُظهر الحلقة الأخيرة تفصيلًا يفاجئ الناس: المفتاح النصي الذي يشبه عددًا صحيحًا، مثل "1"، يُخزَّن على أنه العدد الصحيح 1. أما "01" فليس عددًا صحيحًا بصيغته القياسية، لذا يبقى نصًا.

الحصول على الفهرس في foreach

في القائمة، المفتاح هو الفهرس، لذا فإن foreach ($items as $i => $item) كل ما تحتاجه. وفي المصفوفة الترابطية لا يوجد موضع رقمي، فاحتفظ بعداد. ولمعاملة العنصر الأول أو الأخير معاملة مختلفة، قارن المفتاح بـ array_key_first() أو array_key_last().

<?php
$steps = ['Preheat', 'Mix', 'Bake'];

foreach ($steps as $i => $step) {
    echo "Step ", $i + 1, ": $step\n";   // index starts at 0
}

$scores = ['Ada' => 91, 'Linus' => 78, 'Grace' => 85];
$position = 1;
foreach ($scores as $name => $score) {
    echo "#$position $name ($score)\n";
    $position++;
}

$last = array_key_last($scores);
foreach ($scores as $name => $score) {
    echo $name, $name === $last ? "\n" : ", ";
}

تطبع الحلقة الأخيرة فاصلة بين الأسماء لكن ليس بعد آخرها. لهذه المهمة تحديدًا تكون implode(', ', array_keys($scores)) أقصر؛ أما فحص array_key_last() فهو لحين تحتاج الدورة الأخيرة إلى منطق مختلف، لا إلى فاصل مختلف فقط.

تغيير قيم المصفوفة في foreach (بالمرجع)

$value نسخة. الإسناد إليها لا يغيّر شيئًا في المصفوفة. لتغيير المصفوفة، إما أن تمر بالمرجع باستخدام &$value، أو تكتب عبر المفتاح.

<?php
$prices = [10, 25, 40];

foreach ($prices as $price) {
    $price = $price * 2;          // changes the copy only
}
echo implode(', ', $prices), "\n";

foreach ($prices as &$price) {
    $price = $price * 2;          // changes the array
}
unset($price);                    // break the reference (see next section)
echo implode(', ', $prices), "\n";

foreach ($prices as $key => $price) {
    $prices[$key] = $price + 1;   // same effect, no reference
}
echo implode(', ', $prices), "\n";

كلاهما يعمل. لا يترك أسلوب المفتاح حالة مخفية بعد الحلقة، ولهذا تفضله فرق كثيرة. ولبناء مصفوفة جديدة بدل تغيير مصفوفة قائمة، array_map() خيار آخر.

سؤال ذو صلة: ماذا يحدث إذا أضفت عناصر أثناء المرور؟ تمر foreach العادية على المصفوفة كما كانت عند بدء الحلقة، لذا لا تُنشئ $prices[] = ... داخلها دورات إضافية. أما الحلقة بالمرجع فتمر على المصفوفة الحية وتزور العناصر الجديدة.

مشكلة unset() مع foreach بالمرجع

بعد foreach ($arr as &$v)، يبقى المتغير $v مرجعًا إلى آخر عنصر في المصفوفة. وإذا أعدت لاحقًا استخدام الاسم $v في حلقة عادية، فإن كل دورة تكتب في ذلك العنصر الأخير. شغّل هذا وانظر إلى العنصر الأخير:

<?php
$letters = ['a', 'b', 'c'];

foreach ($letters as &$v) {
    $v = strtoupper($v);
}
// missing: unset($v);

foreach ($letters as $v) {
    // each pass assigns to $v, which is still $letters[2]
}

print_r($letters);   // C was overwritten

$fixed = ['a', 'b', 'c'];
foreach ($fixed as &$v) {
    $v = strtoupper($v);
}
unset($v);           // the fix
foreach ($fixed as $v) {
}
print_r($fixed);

تُسند الحلقة الثانية A، ثم B، ثم قيمة العنصر الأخير نفسه إلى $letters[2]، وفي الدورة الأخيرة تكون تلك الخانة تحمل B أصلًا. والإصلاح سطر واحد: ضع unset($v); مباشرة بعد كل foreach بالمرجع.

break وcontinue في foreach

تغادر break الحلقة، وتقفز continue إلى العنصر التالي. ومن الأنماط الشائعة البحث: مرّ حتى تجد ما تحتاجه، ثم break حتى لا تُفحص بقية المصفوفة.

<?php
$orders = [
    ['id' => 101, 'status' => 'paid'],
    ['id' => 102, 'status' => 'cancelled'],
    ['id' => 103, 'status' => 'paid'],
    ['id' => 104, 'status' => 'pending'],
];

foreach ($orders as $order) {
    if ($order['status'] === 'cancelled') {
        continue;               // skip this one
    }
    echo "Order {$order['id']}: {$order['status']}\n";
}

$found = null;
foreach ($orders as $order) {
    if ($order['status'] === 'pending') {
        $found = $order;
        break;                  // stop searching
    }
}
echo "First pending: ", $found['id'] ?? 'none', "\n";

في الحلقات المتداخلة، تغادر break 2 الحلقة الداخلية والحلقة المحيطة بها، وتقفز continue 2 إلى الدورة التالية من الحلقة الخارجية.

المصفوفات المتداخلة وforeach مع list()

صفوف البيانات مصفوفات داخل مصفوفة. مرّ على الصفوف، ثم على كل صف، أو استخرج الحقول مباشرة في سطر foreach بتفكيك المصفوفة: [$a, $b] للقوائم، و['key' => $var] للصفوف الترابطية. وlist($a, $b) هي الكتابة الأقدم لـ [$a, $b].

<?php
$users = [
    ['name' => 'Ada', 'langs' => ['PHP', 'Python']],
    ['name' => 'Linus', 'langs' => ['C']],
];

// Nested foreach
foreach ($users as $user) {
    echo $user['name'], ":";
    foreach ($user['langs'] as $lang) {
        echo " $lang";
    }
    echo "\n";
}

// Destructuring associative rows
foreach ($users as ['name' => $name, 'langs' => $langs]) {
    echo "$name knows ", count($langs), " language(s)\n";
}

// Destructuring list rows (list() is the same as [])
$points = [[1, 2], [3, 5], [8, 13]];
foreach ($points as [$x, $y]) {
    echo "($x, $y) ";
}
echo "\n";
foreach ($points as list($x, $y)) {
    echo $x + $y, " ";
}

في صفحة التفكيك مزيد عن صيغة [...] =، بما في ذلك تخطي العناصر والأنماط المتداخلة.

بناء قائمة أو جدول HTML باستخدام foreach

في القالب، تُبقي صيغة النقطتين foreach (...): مع endforeach; الحلقة مقروءة بين الوسوم. تبني هذه الكتلة جدولًا، وعناوين الأعمدة روابط: انقر على أحدها في تبويب Page فيعمل السكربت نفسه مرة أخرى مع ضبط $_GET['sort']، فتعود الصفوف بترتيب جديد.

<?php
$products = [
    ['name' => 'Keyboard', 'price' => 49.0, 'stock' => 12],
    ['name' => 'Mouse', 'price' => 19.5, 'stock' => 40],
    ['name' => 'Monitor', 'price' => 189.0, 'stock' => 3],
    ['name' => 'Cable', 'price' => 6.25, 'stock' => 0],
];

$sort = $_GET['sort'] ?? 'name';
if (!in_array($sort, ['name', 'price', 'stock'], true)) {
    $sort = 'name';
}
usort($products, fn($a, $b) => $a[$sort] <=> $b[$sort]);

$total = 0;
foreach ($products as $p) {
    $total += $p['price'] * $p['stock'];
}
?>
<style>
    table { border-collapse: collapse; font-family: sans-serif; }
    th, td { border: 1px solid #ccc; padding: 4px 10px; }
    .out { color: #999; }
</style>
<table>
    <tr>
        <?php foreach (['name', 'price', 'stock'] as $col): ?>
            <th><a href="?sort=<?= $col ?>"><?= ucfirst($col) ?></a><?= $col === $sort ? ' ▲' : '' ?></th>
        <?php endforeach; ?>
    </tr>
    <?php foreach ($products as $p): ?>
        <tr class="<?= $p['stock'] === 0 ? 'out' : '' ?>">
            <td><?= htmlspecialchars($p['name']) ?></td>
            <td><?= number_format($p['price'], 2) ?></td>
            <td><?= $p['stock'] ?></td>
        </tr>
    <?php endforeach; ?>
</table>
<p>Stock value: <?= number_format($total, 2) ?></p>

عادتان تستحقان النسخ من هذه الكتلة: قيمة sort القادمة من الرابط تُفحص مقابل قائمة بالأعمدة المسموحة قبل استخدامها، وكل قيمة تُطبع في HTML وقد تحتوي نصًا من المستخدم تمر عبر htmlspecialchars().

foreach على null أو مصفوفة فارغة أو كائن

المصفوفة الفارغة لا مشكلة فيها: لا يُنفَّذ الجسم أبدًا. أما null أو النص أو العدد فلا: تطبع PHP تحذيرًا وتتخطى الحلقة. مع $tags = null; foreach ($tags as $tag) تطبع:

Warning: foreach() argument must be of type array|object, null given in /var/www/html/index.php on line 4

يحدث هذا أكثر ما يحدث مع بيانات تغيب أحيانًا، مثل حقل اختياري في JSON بعد فك ترميزه. ارجع إلى مصفوفة فارغة باستخدام ??:

foreach ($data['tags'] ?? [] as $tag) {
    echo $tag;
}

كلمة object في تلك الرسالة حقيقية: تزور foreach على كائن خصائصه المرئية من مكان تشغيل الحلقة (العامة منها خارج الصنف)، مع اسم الخاصية مفتاحًا. أما الأصناف التي تنفّذ Iterator أو IteratorAggregate، والمولّدات، فتقرر بنفسها ما تراه foreach.

foreach مقابل for مقابل array_map

طريقة سريعة للحسم: إذا كان جسم الحلقة يحسب قيمة جديدة لكل عنصر فقط، فإن array_map(fn($x) => $x * 2, $a) تقول ذلك في سطر واحد. وإذا كانت له آثار جانبية (طباعة، حفظ، عدّ عدة أشياء معًا) أو يحتاج إلى break، فاكتب foreach.