Php5.5新特性 Generators详解

在PHP5.5.0版本中，新增了生成器*(Generators)特性，用于简化实现迭代器接口(Iterator)*建立简单的迭代器的复杂性。

经过生成器，咱们能够轻松的使用foreach迭代一系列的数据，而不须要事先在内存中构建要被迭代的对象，大大减小了内存开销。

当生成器函数被调用的时候，它会返回一个可迭代的对象，当对该对象进行迭代的时候，PHP将会在须要的时候调用生成器函数，而且在生成器使用新增的关键字yield产生一个新的值的时候，保存迭代器内部的状态。迭代器没有新的值须要产生的时候，生成器函数就能够直接退出，外部函数继续执行。

注意，在生成器函数中，不能使用return语句返回值，使用return返回值的话会产生编译器错误。可是，使用空的return是能够的，它会使迭代器终止。

生成器函数与普通函数同样的，惟一的区别函数内使用了yield关键字。yield语句能够说是生成器函数的核心，简单来讲，yield就像return语句同样，区别是return语句返回后函数就结束了，而使用yield返回后，只是暂停了函数的执行，转到外部函数继续执行，下次调用生成器函数的时候，继续执行生成器函数内部的代码。

####一个简单的例子 - 生成器版本的range函数

一个简单的例子是使用foreach迭代函数range的返回值，若是调用的是range(0, 1000000)的话，将会消耗超过100M的内存。而使用生成器的话，可能只须要消耗1KB内存都不到。

<?php
function xrange($start, $end) {
	if ($start > $end) {
    	throw new RuntimeException("起始值不能大于截止值");
    }
    for ($i = $start; $i <= $end; $i += 1) {
    	// 使用yield关键字，每次到这里函数都会返回$i的值，而且控制权交给外部函数继续执行
        yield $i;
    }
}

foreach (xrange(1, 9) as $number) {
    echo "$number ";
}

上面的例子输出以下：

上述例子中，咱们建立了一个名为xrange的函数，函数中使用yield不断产生返回值，而调用xrange(1, 9)将会建立一个生成器对象。咱们能够修改foreach这一行打印出xrange对象看看

...
$xrange_res = xrange(1, 9);
var_dump($xrange_res);
foreach( $xrange_res as $number){
...

输出

能够看出，执行xrange(1, 9)的时候确实是返回了一个Generator对象。

####使用Generator对象的send方法

在上面的例子中，咱们使用yield语句的时候都是做为单独的一行语句执行的，也就是yield语句产生结果给外部，那么在迭代过程当中有没有办法从生成器函数外部获取值呢？

办法老是有的，由于调用生成器函数后返回的是一个Generator对象，所以咱们能够经过调用该对象的send方法从外部给生成器函数传递一个值，在调用send方法以后，yield会收到send函数发送的值。

<?php
function gen() {
    $ret = (yield 'yield1');
    var_dump("-->" . $ret);

    $ret = (yield 'yield2');
    var_dump("-->" . $ret);
}

$gen = gen();

var_dump($gen->current());
var_dump($gen->send('ret1'));
var_dump($gen->send('ret2'));

输出：

这里咱们首先建立了名为gen的生成器对象，而后打印$gen->current()方法的返回值，该返回值就是迭代器第一次迭代时产生的当前值，所以输出了yield1。

接下来咱们调用了$gen->send('ret')方法，这时，生成器内第一个yield语句返回该方法传递的值ret1，所以输出了$ret的值为ret1。

接着因为生成器内部执行到了第三条语句$ret = (yield 'yield2')，所以外部的第二个var_dump输出了yield2。最后调用$gen->send('ret2')与第一次相似，不过此次生成器内部调用yield以后已经没有yield了，所以返回的是NULL。

注意，这里的$ret = (yield 'yield2')语句中，使用括号包含了yield 'yield2'语句，这里是必须的，若是在表达式上下文中使用yield，必须将yield放在括号内，不然会报错。

####返回关联数组

前面的例子中，咱们使用yield关键字返回的老是单个值，实际上PHP也对返回关联数组提供了支持，基本语法:

yield key => val

使用该语法格式能够在foreach的时候，返回与遍历管理数组相同的结果。

<?php
function gen2() {
    $array = [
        'username' => 'mylxsw',
        'site'     => 'http://aicode.cc'
    ];

    foreach ($array as $key => $val) {
        yield $key => $val;
    }
}

foreach(gen2() as $key => $val) {
    var_dump($key . '   :   ' . $val);
}

输出:

####使用引用

咱们还可让生成器以引用的方式返回数据，这样就能够在生成器外部直接修改生成器内部数据的值。

<?php
function &gen_reference() {
    $value = 3;

    while ($value > 0) {
        yield $value;
    }
}

foreach (gen_reference() as &$number) {
    echo (--$number).'... ';
}

上述例子中，须要注意的是，生成器函数的定义和遍历的时候使用了&$number。

最后，生成器与自定义的迭代器对象是不彻底相同的，生成器一旦开始迭代，就不能再rewind了，只能一直向前迭代，直到迭代完成。若是但愿屡次迭代一个生成器对象的话，能够屡次调用生成器函数建立新的生成器对象或者是使用clone关键字。

---

参考:

• Cooperative multitasking using coroutines (in PHP!)
• Generators