PHP 5.5 Generators example, yield

gistfile1.php

<?php
header("Content-type: text/plain");

function getLinesFromFile($file_path) {

    // На каждой итерации выполняется код до первого yield

    if ( ! $fh = fopen($file_path, 'r')) {
        return;
    }

    $i = 1;
    while (false !== $line = fgets($fh))
    {
        // yield возвращает все итерируемые элементы
        yield str_pad($i++ . '.', 4, ' ') . $line;
    }

    // Если yield не будет вызван - выполнится эта часть ф-ции

    fclose($fh);
}

// выполнения функции не происходит потому как внутри есть yield
$lines = getLinesFromFile(__FILE__);

foreach ($lines as $line) {
    echo "$line";
}