PHPTime

Циклы в PHP: for, while, do-while и foreach

В PHP выбор цикла зависит от того, что управляет следующей итерацией: счётчик, условие или очередной элемент. Разберём четыре конструкции, покажем, как пропускать итерации и выходить из вложенных циклов, и рассмотрим ошибки, которые меняют результат обхода.

Циклы в PHP: какую конструкцию выбрать

Одна итерация — это одно выполнение тела цикла. У for и while условие проверяется перед каждой итерацией, поэтому тело может не выполниться ни разу. do-while проверяет условие после тела, а foreach получает следующий элемент из массива или объекта, поддерживающего обход.

ЦиклКогда применятьЧто завершает обычный обход
forЕсть счётчик, граница и шагУсловие счётчика становится ложным
whileПеред каждой итерацией нужно проверить состояние или прочитать данныеУсловие становится ложным
do-whileСначала нужно выполнить действие, затем решить, повторять ли егоУсловие после итерации становится ложным
foreachНужно обработать элементы массива, итератора или генератораЭлементы заканчиваются

Во всех четырёх циклах можно досрочно выйти через break или пропустить остаток текущей итерации через continue. Для тел циклов используйте фигурные скобки: так при добавлении новой строки кода видно, будет ли она выполняться на каждой итерации.

Цикл for: счётчик, граница и шаг

У for три части. Инициализация выполняется один раз. Условие проверяется перед каждой итерацией. Выражение шага выполняется после тела перед следующей проверкой, в том числе если тело завершилось через continue. Например, смещения для постраничной выборки можно получить так:

PHP
$total = 230;
$pageSize = 100;

for ($offset = 0; $offset < $total; $offset += $pageSize) {
    // Смещения страниц: 0, 100, 200.
    echo $offset, PHP_EOL;
}

Ошибки в границах и индексах

  • У списка из $count элементов индексы начинаются с нуля и заканчиваются на $count - 1. При обходе вперёд используйте $i < $count. Условие $i <= $count добавит обращение к отсутствующему ключу, в том числе для пустого списка.
  • В примере с пагинацией размер страницы должен быть положительным. Нулевой шаг оставит смещение прежним. Отрицательный шаг при движении от нуля к положительной верхней границе уводит счётчик в противоположную сторону.
  • count() возвращает число элементов. После unset() или array_filter() числовые ключи могут содержать пропуски. Для обхода такого массива используйте foreach, а если по контракту нужен список с последовательными индексами, примените array_values().

Если массива внутри цикла не меняется, границу обхода можно вычислить перед циклом. Если меняется, сначала определите, должны ли новые элементы попадать в текущий проход. От этого зависит, нужна ли фиксированная граница или условие должно учитывать изменение размера.

Цикл while в PHP: чтение до конца потока

while удобен, когда число итераций заранее неизвестно. При чтении файла вызов fgets() возвращает строку или false. Проверяйте возвращаемое значение через !== false, чтобы обработать и последнюю строку со значением "0" без перевода строки.

PHP
$stream = fopen('php://temp', 'w+b');
if ($stream === false) {
    throw new RuntimeException('Не удалось открыть поток');
}

try {
    fwrite($stream, "alpha\n\n0");
    rewind($stream);

    while (($line = fgets($stream)) !== false) {
        $value = rtrim($line, "\r\n");
        if ($value === '') {
            continue; // Пропускаем пустую строку.
        }

        echo $value, PHP_EOL; // Напечатает alpha и 0.
    }
} finally {
    fclose($stream);
}

Скобки вокруг присваивания сохраняют в $line результат fgets(). В выражении $line = fgets($stream) !== false сначала вычисляется сравнение, поэтому переменная получит true или false. По той же причине при работе с файлом проверяйте результат самого чтения. Условие !feof($stream) допускает вход в тело перед вызовом, который вернёт false.

Если цикл управляется счётчиком или состоянием, проверьте каждый путь через тело. Типичная ошибка — поставить continue перед обновлением счётчика. Следующая проверка увидит прежнее значение, и цикл может застрять. В примере с файлом очередное чтение выполняется в условии, поэтому пропуск пустой строки не мешает продвижению по потоку.

Цикл do-while: сначала действие, потом проверка

do-while выполняет тело минимум один раз. Он подходит, например, для чтения первой страницы данных, когда признак наличия следующей страницы возвращается вместе с текущей. После закрывающей скобки условия ставится точка с запятой.

PHP
$pages = [
    1 => ['items' => ['A', 'B'], 'next' => 2],
    2 => ['items' => ['C'], 'next' => null],
];

$pageNumber = 1;
do {
    $page = $pages[$pageNumber];
    foreach ($page['items'] as $item) {
        echo $item, PHP_EOL;
    }
    // null обозначает последнюю страницу.
    $pageNumber = $page['next'];
} while ($pageNumber !== null);

Здесь первая страница существует по контракту. Если входные данные допускают отсутствие первой страницы, проверьте её наличие до входа в do-while или используйте while с проверкой перед чтением. При continue в теле do-while управление переходит к проверке условия внизу. К этому моменту переменные условия должны быть инициализированы, а состояние — обновлено.

foreach в PHP: ключи, значения и ссылки

foreach ($items as $value) даёт значение, а foreach ($items as $key => $value) — ключ и значение. Цикл сохраняет ключи массива в том виде, в каком они в нём хранятся. Для ассоциативных массивов он проходит элементы в порядке обхода массива без ручной работы с индексами.

PHP
$stock = ['A-100' => 3, 'B-200' => 0];

foreach ($stock as $sku => $quantity) {
    // Ключ — артикул, значение — остаток.
    echo $sku, ': ', $quantity, PHP_EOL;
}

Как изменить элементы массива

В обычном обходе присваивание нового значения переменной $quantity не заменяет элемент в $stock. Если ключ уже доступен, запишите результат по ключу. Для объектов действует отдельное правило: изменение свойства объекта через переменную цикла затрагивает тот же объект, а присваивание переменной другого объекта не заменяет элемент массива.

PHP
$stock = ['A-100' => 3, 'B-200' => -1];

foreach ($stock as $sku => $quantity) {
    // Записываем исправленное значение в исходный массив.
    $stock[$sku] = max(0, $quantity);
}

При обходе по ссылке, foreach ($stock as &$quantity), присваивание меняет текущий элемент напрямую. Сразу после такого цикла вызовите unset($quantity). Переменная остаётся ссылкой на последний обработанный элемент, и повторное использование её в следующем цикле может незаметно перезаписать этот элемент. unset() разрывает связь с переменной цикла и сохраняет элемент массива.

Обход объектов и генераторов

Параметр типа iterable принимает массив или объект Traversable, в том числе генератор. Сам foreach также умеет обходить видимые свойства обычного объекта. Если функция принимает именно последовательность, тип iterable позволяет отклонить null, строку и обычный объект без интерфейса обхода уже при вызове.

PHP
declare(strict_types=1);

function activeIds(): Generator
{
    // Значения выдаются по запросу обхода.
    yield 101;
    yield 205;
}

function printIds(iterable $ids): void
{
    foreach ($ids as $id) {
        echo $id, PHP_EOL;
    }
}

printIds(activeIds());

Генератор подходит для последовательной обработки по одному элементу. Для полного повторного обхода вызовите activeIds() заново: исчерпанный экземпляр генератора повторно запустить нельзя. Тип iterable задаёт контракт для самой последовательности. Если важен тип каждого элемента, обеспечьте его в источнике данных или проверьте на границе, где данные поступают в приложение.

break и continue в PHP: выход и пропуск итерации

break завершает текущий цикл, и выполнение продолжается после него. continue пропускает оставшийся код текущей итерации. В for после него выполняется шаг, в while и do-while проверяется условие, а в foreach начинается обработка следующего элемента, если он есть.

PHP
$batches = [[0, 8], [0, 42, 7], [99]];
$target = 42;
$found = null;

foreach ($batches as $batchIndex => $batch) {
    foreach ($batch as $id) {
        if ($id === 0) {
            continue; // Пропускаем служебное значение.
        }
        if ($id === $target) {
            $found = $batchIndex;
            break 2; // Выходим из обоих foreach.
        }
    }
}

var_dump($found); // int(1)

Число указывает, сколько уровней вложенности затронуть. break 2 завершает два уровня, а continue 2 переходит к следующей итерации внешнего цикла. Оба оператора учитывают switch при подсчёте уровней. Внутри switch, вложенного прямо в цикл, break завершает только switch, а continue 2 пропускает остаток итерации цикла. Обычный continue, нацеленный на switch, работает как break и вызывает предупреждение E_WARNING.

PHP 8.3–8.5: типизация и поведение циклов

У for, while, do-while, foreach, break и continue в PHP 8.3–8.5 одинаковая семантика для показанных примеров. declare(strict_types=1) ставят в начале PHP-файла. Для вызовов из этого файла директива задаёт строгий режим передачи аргументов со скалярными типами. Условия циклов по-прежнему приводятся к bool: например, 0, строка "0", пустая строка и пустой массив считаются ложными.

С PHP 8.0 чтение отсутствующего ключа массива выдаёт E_WARNING. Это помогает заметить лишнюю итерацию у for или пропуск в числовых ключах. Для поиска числа во входном массиве используйте строгое сравнение ===, если 42 и "42" имеют разный смысл. Если строковые идентификаторы допустимы, приведите их к согласованному типу после проверки входных данных.

Начиная с PHP 8.4, для некоторых операций над массивом есть специальные функции. array_find() возвращает первое значение по предикату, array_find_key() — его ключ, а array_any() и array_all() проверяют, подходит ли хотя бы один элемент или все элементы. Эти функции завершают обход, как только определён результат. Для кода с минимальной версией PHP 8.3 тот же контракт можно выразить через foreach с break или ранним return. Если null допустим как найденное значение, array_find_key() позволяет отличить совпадение от отсутствия результата.

Чек-лист перед коммитом

  • Для массива с произвольными ключами выберите foreach. Для счётчика с границей и шагом — for.
  • Проверьте пустой вход, один элемент и последнюю позицию. Для do-while отдельно проверьте, допустим ли первый запуск при любом входе.
  • Убедитесь, что все ветки с continue позволяют циклу продвинуться, а число в break и continue соответствует реальной вложенности, включая switch.
  • Сравнивайте результаты функций чтения с их признаком окончания строго. Для fgets() проверяйте !== false.
  • После обхода по ссылке сбросьте переменную через unset(). Если нужно добавлять или удалять элементы при обходе, явно определите, какие из них должны обработаться в текущем проходе.

Частые вопросы

Как получить ключ и значение в foreach в PHP?

Используйте <code>foreach ($items as $key =&gt; $value)</code>. Если ключ в теле цикла не нужен, достаточно <code>foreach ($items as $value)</code>.

Чем while отличается от do-while в PHP?

<code>while</code> проверяет условие до выполнения тела и может пропустить его целиком. <code>do-while</code> выполняет тело один раз, затем проверяет условие перед повтором.

Чем break отличается от continue в PHP?

<code>break</code> завершает цикл, а <code>continue</code> пропускает остаток текущей итерации. Во вложенных циклах <code>break 2</code> завершает оба цикла, а <code>continue 2</code> переходит к следующей итерации внешнего.

Справка по теме

Ещё в разделе «Справочник PHP»

Что нового в PHP 8.x: от 8.0 до 8.5

Разбираем, что изменилось в PHP 8.0–8.5: типы, enum, readonly, хуки свойств и оператор pipe. Примеры кода, ошибки совместимости и чек-лист обновления.

9 мин

Composer: установка, composer.json и управление зависимостями

Как установить Composer для PHP 8.3–8.5, настроить composer.json и автозагрузку PSR-4, обновлять зависимости и устранять конфликты версий.

8 мин

Cookie в PHP: setcookie, чтение, удаление и флаги безопасности

Как установить, прочитать и удалить cookie в PHP 8.3–8.5. Примеры setcookie и $_COOKIE, настройка Secure, HttpOnly и SameSite, разбор типичных ошибок.

9 мин

cURL в PHP: GET и POST запросы, заголовки, JSON API

Как отправить GET и POST запросы через cURL в PHP 8.3–8.5, передать заголовки и JSON, проверить HTTP-статус и обработать ошибки соединения и API.

9 мин