PHP yield from 生成器用法探究 (二)

继续

上次给大家讲了PHP yield 的用法，今天给大家讲讲 yield from。

看到这里来，一定是 PHP.net 看得不过瘾吧，这篇文章一定把 yield from 语法给你讲透彻。

语法

<?php
function func()
{
    $re = (yield from $expression);
}

是的，和yield一样，这是一个生成器语法。$expression 是必须（yield 可以为空为NULL),且必须是可迭代对象。

快速上手

小例子1

<?php
function yield_from_func()
{
    (yield from array(1, 2, 3, 4));
}

foreach (yield_from_func() as $value)
{
    echo 'value is : ' . $value . PHP_EOL;
}

• 运行输出

  $ php ./test.php
  

value is : 1
value is : 2
value is : 3
value is : 4

通过以上例子，可得 `yield from` 能把个数组(也可以是迭代器)一个个遍历并送出来。

#### 小例子2

```php
<?php
function yield_func()
{
    yield 1;
    yield 2;
    yield 3;
}

function yield_from_func2()
{
    (yield from yield_func());
}

$gen = yield_from_func2();
echo 'value is : ' . $gen->current() . PHP_EOL;
$gen->next();
echo 'value is : ' . $gen->current() . PHP_EOL;
$gen->next();
echo 'value is : ' . $gen->current() . PHP_EOL;
$gen->next();

• 运行输出

  $ php ./test.php
  

value is : 1
value is : 2
value is : 3

小例子2里，`yield from` 右侧是生成器时， 调用`next`，`current` 也能将生成器内的元素一个个送出。

#### 小例子3

```php
<?php

function yield_func()
{
    echo 'run yield_func' . PHP_EOL;
    $get = (yield 12);
    echo $get . PHP_EOL;
    $get2 = (yield 55);
    echo $get2 . PHP_EOL;
    return 'a';
}

function yield_from_func()
{
    echo 'run yield_from_func' . PHP_EOL;
    $re = (yield from yield_func());
    return $re;
}
$gen2 = yield_from_func();

$re = $gen2->current();
echo 'get re: ' . $re . PHP_EOL;
$gen2->send(100);
$re2 = $gen2->current();
echo 'get re2: ' . $re2 . PHP_EOL;
$gen2->send('world');
$re3 = $gen2->getReturn();
echo 'get return: ' . $re3 . PHP_EOL;

运行流程图如下：

看过我之间那篇文章的读者，这图就非常熟悉了，左边是以前的，最右侧是新加的 yield_from_func() ，对比发现，在外部调用 yield_from_func() 的 current(), send() 和直接调用 yield_func() 的 current(), send()的结果是一样的。yield from 他就是原封不动地把生成器的中间值传来传去， 他就是一个桥梁，通过它可以把 current,send,next,传递进去，还能把里面yield的值送出来。

探个究竟

接下来我们，上全量测试代码。 gitee PHP Generator Yield Demo ，探究一下yield from的各种细节。

git clone https://gitee.com/xupaul/PHP-generator-yield-Demo.git

纸上得来终觉浅，绝知此事要躬行

运行

$ php ./yieldFromTest.php

什么是生成器？

// ./yieldFromFunctions.php
function yield_from_func1()
{
    // yield from ;            // Parse error: syntax error, unexpected ';'
}

有一行代码，被注释了，语法静态检查都不能通过。

上图是生成器判断运行结果，yield_from_func4()， 有个if判断是否运行到 yield from, PHP 依然判定为生成器。

其实到这里，大家一下就清楚了，是不是生成器是静态判断的。

<?php
function yield_from_func3()
{
    yield from 'test';
}
···
echo 'eg: NO.5' . PHP_EOL;
$gen = yield_from_func3();
echo 'call yield_from_func2 current ' . PHP_EOL;
// $re = $gen->current();          // Fatal error: Uncaught Error: Can use "yield from" only with arrays and Traversables
echo PHP_EOL;

• 运行结果：

  eg: NO.5
  yield_from_func4 is PHP Generator? :true
  call yield_from_func2 current

这yield_from_func4虽然判定为生成器，一执行就报错，可得 yield from 右侧必须是一个可遍历对象。

例子8也会运行出错。

current、next 和 send

以上截图，例子1，和例子2，可以看到 yield from 和 yield 的 current，获取当前值，next 跳过， send 向生成器传入值，这些功能和一半生成起都差不多的。

同样，开始时跳过current，直接调用send，会丢失第一次yield的弹出值。

yield from 接收数据

例子：6，7.中，看到截图中例子6 get re: 打印出 $re 是 NULL， list($re1,$re2,$re3)同样也是NULL. 则说明什么，说明了：如果没有显示指定返回则是NULL！

在看到例子：14，15，输出的run to function yield_from_func13 line: 95, var_export re: 211 这一行，打印的是生成器，最后一行return的值。

结论： yield from 左侧不能收到 yeild 弹出的值，但实际它接收的是 生成器内 return的值！

那么send进入的值，去哪了呢，继续看

yield from 嵌套

<?php
function yield_func20 ()
{
    $arr = array();
    echo 'run to function ' . __FUNCTION__ . ' line: ' . __LINE__ . PHP_EOL;
    $arr[] = yield 2;
    $arr[] = yield 'key' => 'value';
    $arr[] = yield 7 => 'cc';
    $arr[] = yield 5;
    echo 'run to function ' . __FUNCTION__ . ' line: ' . __LINE__ . ', arr re: ';
    var_export($arr);
    echo PHP_EOL;
}

例子：9，10中，我们实现了，从生成器中取值。 同时通过 yield_func20 函数内 $arr 变量dump发现，向生成器 send 的值，会通过 yield from 传到内部生成器的 yield 赋值语句.

例子：12，13中，发现，yield from 是可以多层嵌套的。

yield from 的嵌套作用，是非常重要特性，在协程编码中，熟练使用嵌套能减少函数指针，以及生成器的应用传递。

总结

yield from 是一个强大且不可缺少的语法，如果只有 yield 那么就只是有了生成器，有了 yield from 那就有了一根强大的“针”——穿过一个个 生成器，按照call stack 把一个个生成器串了起来。 调用方法用 call_user_func()，调用 生成器用 yield from .

yield from 左侧的变量接收的值，是右侧表达式 return 的值, 右侧表达式内 yield 弹出的值，会被 yield from 继续往外抛。

好，这就是 yield from 用法的探究，实战会放到后续文章。

欢迎提问，如果有帮助请关注，收藏，作者有新的发现，干货，也会更新文章。

本作品采用《CC 协议》，转载必须注明作者和本文链接