PHP 5.5 引入生成器,允許在 foreach 迭代時動態產生值,而非一次性在記憶體建立完整陣列。透過 yield 關鍵字,函數執行可暫停與恢復,極大降低大量資料處理的記憶體佔用。
<?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() 取得) |
<?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";
}
}
<?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+
<?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 |
| 首次迭代延遲 | 高(建立陣列) | 極低(即時產生) |
| 適用場景 | 小資料集、需隨機存取 | 大資料集、串流處理、管道操作 |
iterable 型別提示生成器是 PHP 處理大量資料的利器,善用它能讓你的程式在固定記憶體限制下處理任意大小的資料集。