共计 3731 个字符，预计需要花费 10 分钟才能阅读完成。

PHP 8.x 中的 yield：从入门到精通，解锁迭代器的新姿势

深入聊聊 PHP 中一个非常强大但又常常被忽视的特性——yield。尤其是在 PHP 8.x 版本之后，yield 相关的功能有了一些值得关注的改进。如果你还停留在「yield 就是生成器」的表层认知，那这篇文章可能会给你带来新的启发。

一、什么是 yield？先从基础说起

在 PHP 5.5 中，yield 作为生成器（Generator）的核心关键字被引入。它的基本作用是 在函数执行过程中暂停并返回一个值，而不是像普通函数那样一次性返回所有结果。

举个最简单的例子，用 yield 生成一个数列：

function numberGenerator() {
    yield 1;
    yield 2;
    yield 3;
}
 
// 调用生成器函数，得到一个 Generator 对象
$generator = numberGenerator();
 
// 遍历生成器，获取值
foreach ($generator as $number) {echo $number . ' '; // 输出：1 2 3}

这里的 numberGenerator() 不是普通函数——当它被调用时，函数体并不会立即执行，而是返回一个 Generator 对象。只有当我们遍历这个对象时（比如用 foreach），函数才会逐步执行，每次遇到 yield 就返回一个值，并暂停在那里，下次迭代时再从暂停的地方继续执行。

二、为什么要用 yield？它解决了什么问题？

可能有人会问：直接返回一个数组不也能实现类似功能吗？比如：

function numberArray() {return [1, 2, 3];
}

确实可以，但 yield 的优势在处理 大量数据 或动态生成数据 时才会显现：

1. 内存友好：如果要生成 100 万个数字，数组会一次性占用大量内存，而 yield 每次只生成一个值，内存占用极低。
2. 惰性计算：数据在需要时才生成，适合处理流数据（比如读取大文件、处理数据库结果集）。
3. 简化迭代器实现：在 PHP 中实现 Iterator 接口需要写一堆方法（current()、next()、key() 等），而用 yield 可以一行代码搞定一个迭代器。
   

   三、PHP 8.x 对 yield 的增强：更强大，更灵活

   PHP 8.0 及以上版本对 yield 进行了一些实用改进，让它在实际开发中更易用。

   1. 支持在箭头函数中使用 yield（PHP 8.1+）

   PHP 7.4 引入的箭头函数（短闭包）在 PHP 8.1 中开始支持 yield，这让编写简单的生成器变得更简洁：

   // PHP 8.1 之前：需要用普通闭包
   $generator = function () {
       yield 1;
       yield 2;
   };
    
   // PHP 8.1+：可以用箭头函数
   $generator = fn() => yield from [1, 2];

   注意这里用了 yield from（PHP 7.0 引入），它可以将一个可迭代对象（数组、另一个生成器等）的值逐个返回，相当于「委托」给另一个迭代器。

   2. 生成器返回类型声明的增强（PHP 8.0+）

   PHP 7.0 开始支持生成器的返回类型声明，但在 PHP 8.0 中，对返回类型的校验更严格，同时支持了 static 类型：

   // 正确：返回类型声明为 Generator
   function gen1(): Generator {yield 1;}
    
   // PHP 8.0+ 支持 static 类型（返回当前类的实例）class MyGenerator {public function gen2(): static {yield 2;}
   }

   这里的 static 类型确保生成器返回的是当前类的实例（如果生成器在类中定义），增强了类型安全性。

   3. 与命名参数的配合（PHP 8.0+）

   PHP 8.0 引入的命名参数也可以和生成器结合使用，让代码更清晰。比如在处理数据库结果时：

   function fetchUsers($db, $limit = 10, $offset = 0) {$stmt = $db->prepare("SELECT * FROM users LIMIT :limit OFFSET :offset");
       $stmt->execute(['limit' => $limit, 'offset' => $offset]);
       while ($user = $stmt->fetch(PDO::FETCH_ASSOC)) {yield $user;}
   }
    
   // 使用命名参数调用，更直观
   foreach (fetchUsers($db, limit: 20, offset: 10) as $user) {// 处理用户数据}

   四、yield 的高级用法：不止于「生成值」

   yield 还有一些进阶特性，能应对更复杂的场景。

   1. 带键的 yield

   和数组一样，yield 可以指定键值对：

   function userGenerator() {
       yield 'id' => 1;
       yield 'name' => ' 张三 ';
   }
    
   foreach (userGenerator() as $key => $value) {
       echo "$key: $value\n"; 
       // 输出：// id: 1
       // name: 张三
   }

   2. 向生成器发送值（send() 方法）

   生成器不仅能返回值，还能接收外部传入的值，这让它可以实现双向通信：

   function echoGenerator() {
       $input = yield; // 暂停，等待外部传入值
       echo " 收到：$input\n";
   }
    
   $generator = echoGenerator();
   $generator->next(); // 启动生成器，执行到 yield 处暂停
   $generator->send('Hello, yield!'); // 发送值给生成器，输出：收到：Hello, yield!

   这个特性可以用来实现协程、状态机等高级功能。

   3. 生成器的 return 语句（PHP 7.0+）

   生成器中可以用 return 语句返回一个最终值，通过 getReturn() 方法获取：

   function countGenerator($max) {for ($i = 1; $i <= $max; $i++) {yield $i;}
       return " 完成！共生成 $max 个数字 ";
   }
    
   $generator = countGenerator(3);
   foreach ($generator as $num) {echo $num . ' '; // 输出：1 2 3}
   echo $generator->getReturn(); // 输出：完成！共生成 3 个数字

   五、PHP 8.x 中 yield 的最佳实践

   结合 PHP 8.x 的新特性，分享几个 yield 的实用场景：

   1. 处理大文件

   读取大 CSV 文件时，用 yield 逐行处理，避免一次性加载整个文件到内存：

   function readLargeCsv(string $filename): Generator {$handle = fopen($filename, 'r');
       while (($row = fgetcsv($handle)) !== false) {yield $row; // 逐行返回}
       fclose($handle);
   }
    
   // 遍历处理，内存占用稳定
   foreach (readLargeCsv('large_file.csv') as $row) {processRow($row);
   }

   2. 优化数据库查询

   当查询结果集很大时，用生成器逐步获取数据，而不是一次性 fetchAll()：

   function queryUsers(PDO $pdo, string $sql): Generator {$stmt = $pdo->query($sql);
       while ($user = $stmt->fetch(PDO::FETCH_OBJ)) {yield $user;}
   }
    
   // 每次只加载一条用户数据
   foreach (queryUsers($pdo, 'SELECT * FROM users') as $user) {echo $user->name;}

   3. 实现无限序列

   用 yield 可以轻松实现无限迭代的序列（比如斐波那契数列），因为它不需要预先计算所有值：

   function fibonacci(): Generator {
       $a = 0;
       $b = 1;
       while (true) {
           yield $a;
           [$a, $b] = [$b, $a + $b]; // PHP 7.1+ 解构赋值
       }
   }
    
   $fib = fibonacci();
   for ($i = 0; $i < 10; $i++) {echo $fib->current() . ' ';
       $fib->next();}
   // 输出：0 1 1 2 3 5 8 13 21 34

   六、总结：yield 是 PHP 迭代器的「瑞士军刀」

   从 PHP 5.5 到 PHP 8.x，yield 经历了多次增强，从一个简单的生成器工具逐渐成为处理迭代、流数据、内存优化的核心特性。它的优势在于：

• 低内存占用：特别适合大数据场景；
• 惰性计算：按需生成数据，提升效率；
• 简化代码：替代复杂的 Iterator 实现；
• 双向通信：通过 send() 实现灵活的交互。

  如果你还没在项目中用起来 yield，不妨从处理大文件、数据库结果集这些场景开始尝试，相信会给你带来不少惊喜。

  最后，欢迎在评论区分享你使用 yield 的经验或技巧，一起交流进步！