PHP下的異步嘗試一：初識生成器

PHP下的異步嘗試系列

1. PHP下的異步嘗試一：初識生成器
2. PHP下的異步嘗試二：初識協程
3. PHP下的異步嘗試三：協程的PHP版thunkify自動執行器
4. PHP下的異步嘗試四：PHP版的Promise
5. [PHP下的異步嘗試五：PHP版的Promise的繼續完善]

生成器類

# http://php.net/manual/zh/class.generator.php
Generator implements Iterator {
    /* Methods */
    //獲取迭代器當前值
    public mixed current ( void )
    //獲取迭代器當前值
    public mixed getReturn ( void )
    //返回當前產生的鍵
    public mixed key ( void )
    //生成器從上一次yield處繼續執行
    public void next ( void )
    //重置迭代器
    public void rewind ( void )
    //向生成器中傳入一個值
    public mixed send ( mixed $value )
    //向生成器中拋入一個異常
    public mixed throw ( Throwable $exception )
    //檢查迭代器是否被關閉
    public bool valid ( void )
    //迭代器序列化時執行的方法
    public void __wakeup ( void )
}

生成生成器

嘗試實例化類

$gen = new Generator();

# 咱們發現不能直接手動實例化
# output
PHP Fatal error:  Uncaught Error: The "Generator" class is reserved for internal use and cannot be manually instantiated in /web/www/sxx_admin3/src/cache/test/amphp/gen3.php:8

嘗試function方式

function gen($max)
{
    for ($i=0; $i<$max; $i++) {
        yield $i;
    }
}

$gen = gen(5);

# success
# 成功，咱們只須要在普通函數方法裏yield便可成了生成器

理解php的生成器

其實各語言都有生成器，好比python，go等

生成器迭代foreach

被代碼將演示valid, getReturn

function gen($max)
{
    for ($i=0; $i<$max; $i++) {
        yield $i;
    }
    
    return $max;
}

$gen = gen(5);

foreach ($gen as $val) {
     var_dump($val);
}

//若是已經迭代完成，獲取返回值
// php7 支持
// valid 判斷當前迭代器是否迭代完成
// getReturn 返回迭代器的返回值
if (version_compare(PHP_VERSION, '7.0.0') >= 0 && !$gen->valid()) {
    var_dump($gen->getReturn());
}

帶key值的生成器迭代foreach

迭代器返回值能夠帶key和value，相似

function gen($max)
{
    for ($i=0; $i<$max; $i++) {
        yield $i => $i+1;
    }
    
    return $max;
}

$gen = gen(5);

//var_dump($gen->key());
//var_dump($gen->current());

foreach ($gen as $key=>$val) {
     var_dump($key . "=>" . $val);
}

# output
string(4) "0=>1"
string(4) "1=>2"
string(4) "2=>3"
string(4) "3=>4"
string(4) "4=>5"

生成器迭代手動迭代

本代碼將演示rewind, next, send方法

function gen($max)
{
    for ($i=0; $i<$max; $i++) {
        // 此處的(yield $i)在php7之後版本可省略
        $res = (yield $i);
        var_dump($res);
    }

    return $max;
}

$gen = gen(10);

// 可不調用，隱式調用
// 若是迭代開始後不能再rewind（即便用了next或send後）
$gen->rewind();

// 打印獲取到當前生成器的值
var_dump("1::" . $gen->current()); //output: string(4) "1::0"

// 下面2句代碼執行，將返回錯誤
// $gen->next();
// $gen->rewind();

//繼續執行，知道遇到下一個yield
$gen->next();
var_dump("2::" . $gen->current()); //output: string(4) "2::1"
$gen->next();
var_dump("3::" . $gen->current()); //output: string(4) "3::2"

// send傳null值等同於調用next（本方法嘗試來自python的迭代器，成功）
$gen->send(null);
var_dump("4::" . $gen->current()); //output: string(4) "4::3"

// send傳值會也會繼續執行
$gen->send(100);
var_dump("5::" . $gen->current()); //output: string(4) "5::4"


//若是已經迭代完成，獲取返回值
// php7 支持
if (version_compare(PHP_VERSION, '7.0.0') >= 0 && !$gen->valid()) {
    var_dump($gen->getReturn());
}

# output:
string(4) "1::0"
NULL
string(4) "2::1"
NULL
string(4) "3::2"
NULL
string(4) "4::3"
int(100)
string(4) "5::4"

# 咱們先不去理會gen裏var_dump輸出的NULL或int(100)
# 咱們先去理解每次next後current能夠獲取到當前yield的值便可

嘗試理解send輸出

function gen($max)
{
    for ($i=0; $i<$max; $i++) {
        $res = (yield $i);
        var_dump($res);
    }

    return $max;
}

$gen = gen(10);

var_dump("1::" . $gen->current());

$gen->send(222);
var_dump("2::" . $gen->current());

$gen->send(333);
var_dump("3::" . $gen->current());

$gen->send(null);
var_dump("4::" . $gen->current());


# output：
string(4) "1::0"
int(222)
string(4) "2::1"
int(333)
string(4) "3::2"
int(444)
string(4) "4::3"

# send和next
# next() => current = yield值
# send(val) $rs = yield 表達式執行 = val; //send這樣理解便可
# 在當前某個yield處時send，當前yield表達式處返回，若是沒有變量接收，那麼繼續下一個yield處返回
$rs = (yield  somethind_to_do(...) );
 ^           |-------------------|
 |                  yield值
 |    |----------------------------|
 |               yield 表達式
yield表達式結果


# 執行順序流程相似
$res = (yield 1);   // <- var_dump("1::" . $gen->current()); 第一步到yield返回

var_dump($res);     // <- $gen->send(222); 第二步send：222後，繼續往下走$res=222 而後var_dump($res), 而後到了yield 2
$res = (yield 2);   // <- var_dump("2::" . $gen->current());  打印當前的值2

var_dump($res);     // <- $gen->send(333); 第三步send：333後，繼續往下走$res=333 而後var_dump($res), 而後到了yield 3
$res = (yield 3);   // <- var_dump("3::" . $gen->current());

var_dump($res);     // <- $gen->send(null); 第二步send：null後，繼續往下走$res=null 而後var_dump($res), 而後到了yield 4
$res = (yield 4);   // <- var_dump("4::" . $gen->current());

生成器throw拋出錯誤

# 內部定義異常並返回，外部接收
function gen() {
    echo "Gen 開始\n";
    yield new Exception('內部定義異常');
    echo "Gen 結束\n";
}

$gen = gen();
try {
    throw $gen->current();
} catch (\Exception $e) {
    echo "外部捕獲異常：" . $e->getMessage() . PHP_EOL;
}

$gen->send("123");

# output: 
Gen 開始
外部捕獲異常：內部定義異常
Gen 結束


# 內部接收send傳入的異常，而後直接throw，外部接收
function gen() {
    echo "Gen 開始\n";
    throw (yield new Exception('內部定義異常'));
    echo "Gen 結束\n";
}

$gen = gen();
try {
    throw $gen->current();
} catch (\Exception $e) {
    echo "外部捕獲異常：" . $e->getMessage() . PHP_EOL;
}

try {
    $gen->send(new \Exception("外部定義異常"));
} catch (\Exception $e) {
    echo "外部捕獲異常：" . $e->getMessage() . PHP_EOL;
}

# output
Gen 開始
外部捕獲異常：內部定義異常
外部捕獲異常：外部定義異常

# 
function gen() {
    echo "Gen 開始\n";
    try {
        yield new Exception('內部定義異常');
    } catch (Exception $e) {
        echo "內部捕獲異常：" . "Exception: {$e->getMessage()}\n";
    }

    echo "Gen 結束\n";
}

$gen = gen();
try {
    throw $gen->current();
} catch (\Exception $e) {
    echo "外部捕獲異常：" . $e->getMessage() . PHP_EOL;
}

// 注意這裏是throw方法，至關於
// $gen->send(new \Exception("外部定義異常"));
// throw yield (yield接收 = new \Exception("外部定義異常"))
$gen->throw(new \Exception("外部定義異常"));

#output 
Gen 開始
外部捕獲異常：內部定義異常
內部捕獲異常：Exception: 外部定義異常
Gen 結束

總結

初識咱們只須要先理解next和send便可
next->讓咱們能夠主動自動執行迭代器
send->能夠讓咱們的迭代器實現雙向通訊，改變執行體流程順序
後續咱們會介紹使用場景和Co自動執行體等

文章改名記錄

2018.09.20: [PHP下的生成器嘗試一：初識PHP下的生成器] -> [PHP下的異步嘗試一：初識生成器]