Чем может быть полезен генератор в PHP?

Слушай, объясняю на пальцах, а то у некоторых от таких слов, как «генератор», сразу волнение ебать начинается и терпения ноль. Представь себе, что тебе нужно перетаскать тонну картошки из подвала на кухню. Можно, конечно, взять один мешок и набить его до отвала, но ты его ебёшься не поднимешь, да и спина хрустнет. А можно брать по одной картошке и бегать туда-сюда — тоже пиздец, замучаешься.

Генератор в PHP — это как умная хуйня, которая даёт тебе картошку по одной штуке прямо в руки, но при этом ты стоишь на месте, а она сама из подвала достаёт. То есть, ты обрабатываешь данные по одному элементу, не загружая в память весь этот овердохуища массив сразу. Гениально же, ёпта!

Вот смотри, классический пример — чтение огромного лог-файла. Без генератора код выглядит как манда с ушами:

function readAllLines(string $file): array {
    $lines = [];
    $handle = fopen($file, 'r');
    while (($line = fgets($handle)) !== false) {
        $lines[] = trim($line); // Все строки хранятся в памяти!
    }
    fclose($handle);
    return $lines; // Массив может быть огромным
}

Ты что делаешь? Читаешь весь файл, пихаешь каждую строку в массив $lines, и в конце возвращаешь эту гигантскую хуйню. Если файл на 10 гигабайт, то скрипт просто накрывается медным тазом, потому что памяти не хватит. Пиздопроебибна ситуация.

А теперь с генератором — красота, ядрёна вошь!

function readLinesGenerator(string $file): Generator {
    $handle = fopen($file, 'r');
    while (($line = fgets($handle)) !== false) {
        yield trim($line); // Возвращает одну строку и приостанавливается
    }
    fclose($handle);
}

// Использование
foreach (readLinesGenerator('huge_log.txt') as $line) {
    // Обрабатываем строку $line. В памяти всегда только одна строка.
    if (str_contains($line, 'ERROR')) {
        echo $line . PHP_EOL;
    }
}

Видишь магию? Ключевое слово yield — это и есть вся соль. Оно не возвращает значение окончательно, а как бы «выплёвывает» его наружу и засыпает до следующего витка цикла. В памяти в каждый момент времени живёт только одна строка файла. Ты можешь хоть терабайтный файл читать — памяти жрётся фиксированно мало. Это же ебушки-воробушки!

Так нахуя это вообще нужно?

1. Ленивые вычисления (lazy evaluation). Генератор не делает всю работу сразу, а только тогда, когда у него очередное значение выпрашивают в цикле. Не просишь — не пашет. Хитрая жопа.
2. Экономия памяти — это главный козырь, уже объяснил. Не надо создавать промежуточные массивы на миллион элементов.
3. Бесконечные последовательности. Можешь сделать генератор, который выдаёт, например, числа Фибоначчи до бесконечности. Цикл foreach будет брать их по одному, и хоть сто лет можешь крутить, память не кончится. Главное — вовремя остановиться, а то зациклишься как полупидор.
4. Код проще. Раньше, чтобы сделать такую штуку, надо было реализовывать целый интерфейс Iterator с кучей методов — rewind, valid, current, next. Сейчас написал функцию с yield — и всё, ты красавчик. Гораздо меньше писанины и мозговой боли.

Короче, если видишь задачу, где нужно перебрать хуй с горы данных, но загружать их все сразу — плохая идея, сразу думай про генераторы. Это один из тех инструментов, который реально делает код лучше и эффективнее, а не просто для галочки в резюме.