PHP函数如何创建与使用生成器函数 PHP函数生成器函数的定义与应用教程-php教程-PHP中文网

PHP函数如何创建与使用生成器函数 PHP函数生成器函数的定义与应用教程

絕刀狂花

发布： 2025-08-12 23:47:02

原创

976人浏览过

生成器函数与传统数组的主要区别在于，生成器采用“按需供给”模式，仅在迭代时逐个生成值并暂停执行，内存占用恒定，而传统函数会一次性将所有结果存入数组，占用大量内存；这种特性使生成器在处理大文件、无限数据流或海量数据时具有显著优势，例如逐行读取gb级日志文件、解析大型csv或xml文件、生成大范围数字序列等场景，能有效避免内存溢出，提升性能，实现高效的数据处理。

PHP函数如何创建与使用生成器函数 PHP函数生成器函数的定义与应用教程

PHP生成器函数，说白了，就是一种能让你在需要时才生成数据的函数。它不像传统函数那样，一股脑儿地把所有结果都计算出来并返回一个大数组，而是每次迭代都“吐”出一个值，然后暂停，等待下一次“拉取”。这种“按需供给”的模式，对于处理海量数据或者那些理论上无限的数据流，简直是内存和性能的救星。你只需要在函数体里用到

yield

登录后复制

关键字，它就自动成了生成器。每次

yield

登录后复制

，函数就会暂停并返回一个值，但它的内部状态，包括所有局部变量和当前的执行位置，都会被悄悄地保存下来，直到下一次迭代请求时，它会从上次停下的地方继续执行。

要创建一个PHP生成器函数，核心就是那个

yield

登录后复制

关键字。它有点像

return

登录后复制

，但又完全不同。

return

登录后复制

是函数执行的终点，而

yield

登录后复制

只是一个暂停点。

比如，我们想生成一个从1到N的数字序列，但N可能非常大，大到我们不想一次性把所有数字都放到内存里：

立即学习“PHP免费学习笔记（深入）”；

<?php

function generateNumbers(int $limit) {
    for ($i = 1; $i <= $limit; $i++) {
        // 每次循环，yield都会返回当前$i的值，并暂停函数执行
        yield $i;
    }
}

// 使用生成器就像使用一个数组一样简单，通过foreach迭代
echo "--- 生成简单数字序列 ---" . PHP_EOL;
foreach (generateNumbers(5) as $number) {
    echo "Generated: " . $number . PHP_EOL;
}

// 实际场景：读取大文件
function readLargeFile(string $filePath) {
    if (!file_exists($filePath)) {
        // 简单错误处理，实际中可能更复杂
        throw new \InvalidArgumentException("文件不存在: " . $filePath);
    }
    $handle = fopen($filePath, 'r');
    if (!$handle) {
        throw new \RuntimeException("无法打开文件: " . $filePath);
    }
    while (!feof($handle)) {
        // 每次读取一行，然后yield出去，不把整个文件读进内存
        $line = fgets($handle);
        if ($line !== false) { // fgets在文件末尾可能返回false
            yield trim($line);
        }
    }
    fclose($handle);
}

echo PHP_EOL . "--- 读取大文件示例 ---" . PHP_EOL;
try {
    // 为了演示，我这里手动创建一个小文件内容，方便测试
    $tempFile = 'temp_large_log.txt';
    file_put_contents($tempFile, "First line.\nSecond line.\nThird line.\nAnother line here.\n");

    foreach (readLargeFile($tempFile) as $line) {
        if (!empty($line)) { // trim后可能为空
            echo "Read line: " . $line . PHP_EOL;
        }
    }
    unlink($tempFile); // 清理临时文件
} catch (\Exception $e) {
    echo "Error: " . $e->getMessage() . PHP_EOL;
}

// 更高级的用法：yield from
// yield from 可以将生成器的控制权委托给另一个生成器或可遍历对象
function generateEvenNumbers(int $start, int $end) {
    for ($i = $start; $i <= $end; $i++) {
        if ($i % 2 === 0) {
            yield $i;
        }
    }
}

function generateMixedNumbers() {
    yield 0;
    // 将控制权委托给generateEvenNumbers，它会依次yield出偶数
    yield from generateEvenNumbers(1, 6);
    yield 7;
}

echo PHP_EOL . "--- 使用 yield from ---" . PHP_EOL;
foreach (generateMixedNumbers() as $num) {
    echo "Mixed Number: " . $num . PHP_EOL;
}

?>

登录后复制