萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 生成器 Generator 入門:記憶體高效的迭代實現

什麼是生成器

PHP 5.5 引入生成器,允許在 foreach 迭代時動態產生值,而非一次性在記憶體建立完整陣列。透過 yield 關鍵字,函數執行可暫停與恢復,極大降低大量資料處理的記憶體佔用。

傳統 range() vs 生成器 xrange()

<?php
// 傳統方式:一次性建立 1 億個元素陣列
// 會導致:Fatal error: Allowed memory size exhausted
// range(1, 100000000); 

// 生成器方式:每次只產生一個值
function xrange($start, $limit, $step = 1) {
    for ($i = $start; $i <= $limit; $i += $step) {
        yield $i; // 暫停並返回值,下次迭代從這裡繼續
    }
}

// 使用:只佔用極少記憶體
foreach (xrange(1, 9, 1) as $number) {
    echo "$number "; // 輸出: 1 2 3 4 5 6 7 8 9
}

生成器核心特性

特性說明
惰性求值只有迭代時才計算下一個值
狀態保持函數區域變數在 yield 之間保持
雙向通訊可透過 send() 向生成器傳值
異常處理可用 throw() 向生成器拋出異常
返回值PHP 7+ 支援 return 返回最終值(getReturn() 取得)

進階用法範例

1. 讀取大型檔案(逐行處理)

<?php
function readLines($filename) {
    $handle = fopen($filename, 'r');
    try {
        while (($line = fgets($handle)) !== false) {
            yield rtrim($line);
        }
    } finally {
        fclose($handle);
    }
}

// 使用:記憶體常數級佔用
foreach (readLines('huge_log.txt') as $lineNum => $line) {
    if (strpos($line, 'ERROR') !== false) {
        echo "Line $lineNum: $line\n";
    }
}

2. 雙向通訊:協程雛形

<?php
function logger() {
    echo "Logger started\n";
    while (true) {
        $msg = yield; // 接收外部傳入的值
        if ($msg === 'STOP') break;
        echo "LOG: $msg\n";
    }
    return "Logger stopped";
}

$log = logger();
$log->next(); // 啟動生成器(移至第一個 yield)
$log->send('User login');
$log->send('Database connected');
$log->send('STOP');
echo $log->getReturn(); // PHP 7+

3. 遞迴生成器:遍歷目錄樹

<?php
function scanDir($dir) {
    $files = scandir($dir);
    foreach ($files as $file) {
        if ($file === '.' || $file === '..') continue;
        $path = $dir . DIRECTORY_SEPARATOR . $file;
        if (is_dir($path)) {
            yield from scanDir($path); // PHP 7+ 委派生成器
        } else {
            yield $path;
        }
    }
}

foreach (scanDir('/var/www') as $file) {
    echo "$file\n";
}

效能對比

指標range(1, 1000000)xrange(1, 1000000)
記憶體峰值~32 MB~300 KB
首次迭代延遲高(建立陣列)極低(即時產生)
適用場景小資料集、需隨機存取大資料集、串流處理、管道操作

最佳實踐

  • 處理大型 CSV/JSON/日誌檔案時優先使用生成器
  • 資料庫大量查詢結果可封裝為生成器逐行處理
  • 管道操作(過濾、轉換、聚合)鏈式組合生成器
  • 避免在生成器中執行耗時阻塞操作(影響迭代效能)
  • PHP 7.1+ 可使用 iterable 型別提示

生成器是 PHP 處理大量資料的利器,善用它能讓你的程式在固定記憶體限制下處理任意大小的資料集。

copyright © 萬盛學電腦網 all rights reserved