Цикл 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);

Второй цикл присваивает $letters[2] сначала A, потом B, а потом собственное значение последнего элемента, а к последнему проходу в этой ячейке уже лежит 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 из URL сверяется со списком разрешённых столбцов до использования, а каждое значение, которое попадает в 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.