yield再入門 #phpcon

PHP Conference Japan 2026の発表資料です
https://fortee.jp/phpcon-2026/proposal/ff2e3fc0-d670-439e-b39b-2e9d71444767

Transcript

1. yield再入門 PHP Conference Japan 2026 Hideki Kinjyo GitHub: o0h / X: @o0h_ [発表用] v2.1.4
2. 2 スライド番号この辺 本資料の文字サイズ・オブジェクトのサンプルです。 最大表示領域とあわせて、ご確認ください。 [見えにくい場合] 資料を公開済みなので、ぜひお手元にご用意ください => https://speakerdeck.com/o0h/phpcon-2026 or Fortee から ・太字もあります Shape ・カラー1・カラー2・カラー3 ・font1・font2・ font3 四 角 ) The sample code is written in this font. 本文や吹き出し内で この文字サイズ(48pt)の テキストが 使われています。 問題なく読めますか？ 縦 下幅 まは で最 見 大 切で れこ ずこ にま 見で え使 まい すま かす ？ ( 発表に入る前に: 環境テスト
3. yield再入門 PHP Conference Japan 2026 Hideki Kinjyo GitHub: o0h / X: @o0h_
4. 4 みなさん、どうも こんにちyield〜〜！🎉
5. 5 PHPには `yield` というものが あります
6. 6 since PHP 5.5〜 PHPには `yield` というものが ありまして
7. 7 マニュアル曰く 最もシンプルな書きかたを すると、yield 文の見た目 は return 文とほぼ同じに なります。 <https://www.php.net/manual/ja/language.generators.syntax.php>
8. function nanika() { return 100; }
9. function nanika() { return 100; } returnを置き換えるだけ function nanika2() { yield 100; }
10. function nanika() { return 100; } var_dump(nanika()); int(100)
11. function nanika2() { yield 100; } var_dump(nanika2()); object(Generator)#1 (1) { ["function"]=> string(7) "nanika2" }
12. function nanika2() { yield 100; } var_dump(nanika2()); ？ Generator object(Generator)#1 (1) { ["function"]=> string(7) "nanika2" }
13. 13 マニュアル(当時)を見てみても・・ <https://php-legacy-docs.zend.com/manual/php5/en/migration55.new-features>
14. 14 「Generatorが追加された」「yield使うよ」 と紹介されている
15. 15 yield = Generatorのための キーワード
16. 16 ★☆ 本日のテーマ☆★ yieldやGeneratorと 顔見知りになろう
17. 17 こんな感じで話します 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装
18. 18 こんな感じで話します 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 そもそも、コレ何だっけ？の話 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装
19. 19 こんな感じで話します 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 yieldが持つ機能や 呼び出し方の共有
20. 20 こんな感じで話します 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 この機能の、 そもそもの「意図」を探る
21. 21 こんな感じで話します 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 「何をもたらしているのか」を 客観的な事実から理解
22. 22 3つの観点から、 ただの「return」や 「イテレータ」との違いを 理解していきましょう
23. 23 自己紹介 • 金城秀樹 / きんじょうひでき • GitHub: @o0h / : @o0h_ • 好きなFWはCakePHP • アイコンは美味しい鮭親子丼の写真です • Podcast 「readline.fm」 • mix2コミュニティ 𝕏 「深夜に美味しいご飯の写真を上げよう部」管理人
24. 24 ご連絡 この資料の後半に、 発表時間の都合でカットしたものを 付けてあります 良かったらご覧ください！！
25. 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
26. サマリーだけ話します 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
27. 27 yieldとGenerator function nanika2() { yield 100; } var_dump(nanika2()); object(Generator)#1 (1) { ["function"]=> string(7) "nanika2" } yieldを含むfunctionは、 実行すると Generatorを生成する
28. 28 強引なイメージによる説明(※正しくない) function nanikaX() { return new Generator(▪▪▪); } $g = nanikaX(); 「オブジェクトを生成する」 という側面だけで言うなら、 まずは、 こんな風に捉えると良いかも
29. 29 シンプルなイテレータを簡単に作れるやつ！！ <https://php.net/generators.overview>
30. 30 PHPと反復処理 iterable(疑似型) Traversable Iterator PHPにおける 反復処理の対応 array 「foreachに渡せる」もの と覚えればOK IteratorAggregate
31. 31 Iteratorの実装例 $iterator = new class($data) implements Iterator { private array $keys; private int $position = 0; private array $data = ['a' => true, 'b' => false, 'c' => true]; public function __construct() { $this->keys = array_keys($this->data); } public function rewind(): void { $this->position = 0; } public function valid(): bool { return isset($this->keys[$this->position]); } public function current(): mixed { return $this->data[$this->keys[$this->position]]; } public function key(): mixed { return $this->keys[$this->position]; } public function next(): void { $this->position++; } }; Iterator実装を用意する オーバーヘッドや煩わしさ
32. 32 Iteratorの実装例 $generator = (function() { yield 'a' => true; yield 'b' => false; yield 'c' => true; })(); yieldなら、これだけでOK。 「順番に値を返す」機能を 提供できる
33. ✔ DONE 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
34. 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
35. Generatorとイテレーション
36. 36 yieldの最も基本的な形 function generator() { yield 'a' => true; yield 'b' => false; yield 'c' => true; } $g = generator(); foreach ($g as $k => $v) { printf("%s is %s!!\n", $k, var_export($v, true)); } 単純なイテレーションの例
37. 37 yieldの最も基本的な形 a is true!! b is false!! c is true!! 実行結果
38. 38 yieldの最も基本的な形 function generator() { yield 'a' => true; yield 'b' => false; yield 'c' => true; } `yield` のあとに `キー => 式` $g = generator(); foreach ($g as $k => $v) { printf("%s is %s!!\n", $k, var_export($v, true)); }
39. 39 yieldの最も基本的な形 function generator() { yield true; yield false; yield true; } `キー`は省略OK (代わりに0からの連番になる) $g = generator(); foreach ($g as $k => $v) { printf("%s is %s!!\n", $k, var_export($v, true)); }
40. 40 yieldの最も基本的な形 function generator() { yield 'a' => true; yield 'b' => false; yield 'c' => true; } $g = generator(); `yield` ごとに 1つずつ要素を取り出せる foreach ($g as $k => $v) { printf("%s is %s!!\n", $k, var_export($v, true)); }
41. 41 yieldの最も基本的な形 function generator() { yield 'a' => true; yield 'b' => false; yield 'c' => true; } $g = generator(); var_dump($g->a); var_dump($g['a']); Generatorには 添字でアクセス的なことは できない
42. 42 Iterator APIの利用 $g = generator(); var_dump($g->current()); var_dump($g->key()); $g->next(); var_dump($g->current()); var_dump($g->key()); Iteratorインターフェイス のAPIを利用した例
43. 43 Iterator APIの利用 bool(true) string(1) "a" bool(false) string(1) "b" 実行結果
44. 44 Iterator APIの利用 $g = generator(); var_dump($g->current()); var_dump($g->key()); $g->next(); var_dump($g->current()); var_dump($g->key()); Iteratorインターフェイス のAPIを利用した例
45. 45 Iterator APIの利用 現在の要素を返す $g = generator(); var_dump($g->current()); var_dump($g->key()); $g->next(); 現在の要素のキーを返す var_dump($g->current()); var_dump($g->key());
46. 46 Iterator APIの利用 $g = generator(); var_dump($g->current()); var_dump($g->key()); $g->next(); 次の要素に進む var_dump($g->current()); var_dump($g->key());
47. Generatorと中断・再開
48. 48 Iterator APIの利用・・・なのだけど $g->current(); $g->next(); (シレっと出てきたけど) コレらは何なのか？
49. 49 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); この処理を 詳細に分解して見てみる
50. 50 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); メインルーチンの1ステップ目 $a = $g->current(); $g->next(); $b = $g->current();
51. 51 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); ジェネレータに 「現在の要素を返せ」と命じる
52. 52 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); ジェネレータの内部処理へ
53. 53 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); まだ何も処理をしていないので、 「現在位置」といっても 「どこにもいない」状態
54. 54 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); 最初の「返せる位置」まで進める yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current();
55. 55 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); 最初の「返せる位置」まで進める yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); `yield`は Generator内部の処理を 停止させる この停止機能こそが、 単なる`new Generator`の 糖衣構文ではない理由 (の1つ)
56. 56 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); 停止するべき位置 = yieldが見つかったので
57. 57 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); 右側にある式を評価して
58. 58 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); 呼び出し元に値を返す yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current();
59. 59 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); 返された値の代入
60. 60 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); 次の位置まで処理を進める $g->next(); $b = $g->current();
61. 61 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); 内部位置は今ココ
62. 62 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); 次の位置がココ
63. 63 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); この間を進める
64. 64 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); この間を進める `yield`のもう1つの重要機能 「再開」 内部的な「現在位置」から 続きだけを処理する
65. 65 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); 右側の式を評価して、 yield date(); 処理を停止 yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current();
66. 66 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current();
67. 67 Generatorの処理をstep-by-stepで function generator() { yield random_int(1, 10); 既に「停止済み」なので、 最初の`current()` と違い yield date(); 位置の走査をせず、評価済みの結果を返す yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current();
68. 中断・再開と遅延処理
69. 69 イテレーションの遅延処理 function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); 再掲: Generatorは 「途中で止める」 「途中から動かす」 が出来るので・・
70. 70 イテレーションの遅延処理 function generator() { yield random_int(1, 10); yield date(); yield false; } $g = generator(); $a = $g->current(); $g->next(); $b = $g->current(); これを活かして、 遅延処理が可能になる
71. 71 イテレーションの遅延処理 function a($start) { $data = []; for ($i = $start; $i <= PHP_INT_MAX; $i++) { $data[] = $i; } return $data; } function b($start) { for ($i = $start; $i <= PHP_INT_MAX; $i++) { yield $i; } }
72. 72 イテレーションの遅延処理 function a($start) { $data = []; for ($i = $start; $i <= PHP_INT_MAX; $i++) { $data[] = $i; } 予めデータセットを全部作ろうとすると return $data; メモリ溢れを起こすが・・ } function b($start) { for ($i = $start; $i <= PHP_INT_MAX; $i++) { yield $i; } }
73. 73 イテレーションの遅延処理 function a($start) { $data = []; for ($i = $start; $i <= PHP_INT_MAX; $i++) { $data[] = $i; } ジェネレータで1つずつ取り出すと、 return $data; 軽い処理で済む } function b($start) { for ($i = $start; $i <= PHP_INT_MAX; $i++) { yield $i; } }
74. 74 イテレーションの遅延処理 function filesInDir($directory, $fileExtension) { $directory = realpath($directory); $it = new RecursiveDirectoryIterator($directory); $it = new RecursiveIteratorIterator($it, RecursiveIteratorIterator::LEAVES_ONLY); $it = new RegexIterator($it, '(\.'.preg_quote($fileExtension).'$)'); foreach ($it as $file) { $fileName = $file->getPathname(); yield $fileName => file_get_contents($fileName); } } <https://github.com/nikic/PHP-Parser/blob/v5.8.0/test/bootstrap.php>
75. 75 イテレーションの遅延処理 function filesInDir($directory, $fileExtension) { $directory = realpath($directory); $it = new RecursiveDirectoryIterator($directory); $it = new RecursiveIteratorIterator($it, RecursiveIteratorIterator::LEAVES_ONLY); $it = new RegexIterator($it, '(\.'.preg_quote($fileExtension).'$)'); 「値を返せ」と言われた時に、 foreach ($it as $file)重い(メモリを食う)処理をしている例 { $fileName = $file->getPathname(); yield $fileName => file_get_contents($fileName); } } <https://github.com/nikic/PHP-Parser/blob/v5.8.0/test/bootstrap.php>
76. ✔ DONE 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
77. 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
78. 78 PHPの`yield`って どんな気持ちで 使っていくのが 良いんだろう・・・
79. 79 歴史に訊いてみる (実装背景を知りたい)
80. 80 yield/Generator関連のRFC 3選 1. PHP: rfc:generators https://wiki.php.net/rfc/generators 2. PHP: rfc:generator-return-expressions https://wiki.php.net/rfc/generator-return-expressions 3. PHP: rfc:generator-delegation https://wiki.php.net/rfc/generator-delegation
81. 81 yield/Generator関連のRFC 3選 1. PHP: rfc:generators https://wiki.php.net/rfc/generators はじまり。 5.5で実装済み 2. PHP: rfc:generator-return-expressions https://wiki.php.net/rfc/generator-return-expressions 3. PHP: rfc:generator-delegation https://wiki.php.net/rfc/generator-delegation
82. 82 yield/Generator関連のRFC 3選 1. PHP: rfc:generators https://wiki.php.net/rfc/generators getReturn() 7.0で実装済み 2. PHP: rfc:generator-return-expressions https://wiki.php.net/rfc/generator-return-expressions 3. PHP: rfc:generator-delegation https://wiki.php.net/rfc/generator-delegation
83. 83 yield/Generator関連のRFC 3選 1. PHP: rfc:generators https://wiki.php.net/rfc/generators 2. PHP: rfc:generator-return-expressions yield from。 https://wiki.php.net/rfc/generator-return-expressions 7.0で実装済み 3. PHP: rfc:generator-delegation https://wiki.php.net/rfc/generator-delegation
84. 今回の発表で 取り上げるのはコチラ！ PHP: rfc:generators
85. 85 <https://wiki.php.net/rfc/generators>
86. 86 ジェネレータがあれば、 簡単かつオマジナイも無しで イテレータを実現できるよ！ <https://wiki.php.net/rfc/generators>
87. 87 <https://wiki.php.net/rfc/generators>
88. 88 めっちゃ具体の例として、 PHPUnitのDataProviderの話なんだけど・・ <https://wiki.php.net/rfc/generators>
89. 89 特定ディレクトリにあるテストファイルを 全部読み込んで、処理するような処理 でも、一気に全部メモリに載せるのは 結構しんどそうだ・・・ <https://wiki.php.net/rfc/generators>
90. 90 もちろん、真面目にIteratorを使えば 再帰処理も遅延読み込みもできる！ ・・・でも！ yieldで、もっと簡単に解決できる！！ <https://wiki.php.net/rfc/generators>
91. 1. yield/generator/iteratorのおさらい ✔ DONE 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
92. 92 有益情報のコーナー • 「コルーチンって何、いきなり出てきたね・・」 と思った人に素晴らしい情報です • 『n月刊ラムダノート Vol.1, No.1(2019)』を 買ってください！！ • 第2特集『「 コルーチン」とは何だったのか？』 とにかく素晴らしいので
93. 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
94. 94 動き方や、 想いは分かってきたけど
95. 95 それって一体、 どうやってるんですか？ (を知りたいですよね)
96. どうやって「普通の関数」が 「ジェネレータ関数」になるのか
97. 97 大前提となる知識 PHPのプログラム(スクリプトは)、 「スクリプト」 ⇒ 「AST」⇒「オペコード」⇒「機械語」 と翻訳されて、最終的に実行される <?php class A { ————— ————— ソースコード <?php T_OPEN_TAG if T_IF \s T_WHITESPACE $a T_VARIABLE \s T_WHITESPACE echo T_ECHO $x T_VARIABLE トークン S E Op E var AST val 0 1 2 3 4 5 INIT_FCALL 'hoge' SEND_VAL 1 SEND_VAL 10 DO_ICALL $0 ECHO $0 RETURN 1 オペコード 00110000 00100000 00100000 01001001 01001110 01001001 01010100 01011111 01000110 01000011 01000001 01001100 01001100 00100000 00100111 01101000 01101111 01100111 01100101 00100111 00001010 00110001 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00001010 00110010 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00110000 00001010 00110011 00100000 機械語
98. 98 ASTを見てみる コードを 木構造化する <?php class A { ————— ————— ソースコード <?php T_OPEN_TAG if T_IF \s T_WHITESPACE $a T_VARIABLE \s T_WHITESPACE echo T_ECHO $x T_VARIABLE トークン S E Op E var AST val 0 1 2 3 4 5 INIT_FCALL 'hoge' SEND_VAL 1 SEND_VAL 10 DO_ICALL $0 ECHO $0 RETURN 1 オペコード 00110000 00100000 00100000 01001001 01001110 01001001 01010100 01011111 01000110 01000011 01000001 01001100 01001100 00100000 00100111 01101000 01101111 01100111 01100101 00100111 00001010 00110001 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00001010 00110010 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00110000 00001010 00110011 00100000 機械語
99. 99 ASTノード: 普通の関数 function X() { return random_int(1, 100); } ZEND_AST_FUNC_DECL(name=X) ├ params: ZEND_AST_PARAM_LIST └ body: ZEND_AST_STMT_LIST └ stmt[0]: ZEND_AST_RETURN └ expr: ZEND_AST_CALL ├ callable: ZEND_AST_ZVAL("random_int") └ args: ZEND_AST_ARG_LIST ├ arg[0]: ZEND_AST_ZVAL(1) └ arg[1]: ZEND_AST_ZVAL(100)
100. 100 ASTノード: ジェネレータ関数 function X() { yield random_int(1, 100); } ZEND_AST_FUNC_DECL(name=X) ├ params: ZEND_AST_PARAM_LIST └ body: ZEND_AST_STMT_LIST └ stmt[0]: ZEND_AST_YIELD └ expr: ZEND_AST_CALL ├ callable: ZEND_AST_ZVAL("random_int") └ args: ZEND_AST_ARG_LIST ├ arg[0]: ZEND_AST_ZVAL(1) └ arg[1]: ZEND_AST_ZVAL(100)
101. 101 オペコードを見てみる 木をコンパイルして 低次元なコードにする <?php class A { ————— ————— ソースコード <?php T_OPEN_TAG if T_IF \s T_WHITESPACE $a T_VARIABLE \s T_WHITESPACE echo T_ECHO $x T_VARIABLE トークン S E Op E var AST val 0 1 2 3 4 5 INIT_FCALL 'hoge' SEND_VAL 1 SEND_VAL 10 DO_ICALL $0 ECHO $0 RETURN 1 オペコード 00110000 00100000 00100000 01001001 01001110 01001001 01010100 01011111 01000110 01000011 01000001 01001100 01001100 00100000 00100111 01101000 01101111 01100111 01100101 00100111 00001010 00110001 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00001010 00110010 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00110000 00001010 00110011 00100000 機械語
102. 102 ASTのトラバース＆コンパイル コンパイル: ZEND_AST_FUNC_DECL(name=X) 木を走査していって、 ├ params: ZEND_AST_PARAM_LIST 「対応するコードとデータ) └ body: ZEND_AST_STMT_LIST に変換していく └ stmt[0]: ZEND_AST_RETURN └ expr: ZEND_AST_CALL ├ callable: ZEND_AST_ZVAL("random_int") └ args: ZEND_AST_ARG_LIST ├ arg[0]: ZEND_AST_ZVAL(1) └ arg[1]: ZEND_AST_ZVAL(100)
103. 103 ASTのトラバース＆コンパイル ZEND_AST_FUNC_DECL(name=X) ├ params: ZEND_AST_PARAM_LIST └ body: ZEND_AST_STMT_LIST 例えば、 └ stmt[0]: ZEND_AST_RETURN `ZEND_AST_FUNC_DECL`なら └関数宣言ノード expr: ZEND_AST_CALL ├ `zend_compile_func_decl()` callable: ZEND_AST_ZVAL("random_int") が担当 └ args: ZEND_AST_ARG_LIST ├ arg[0]: ZEND_AST_ZVAL(1) └ arg[1]: ZEND_AST_ZVAL(100)
104. 104 ASTのトラバース＆コンパイル ZEND_AST_FUNC_DECL(name=X) ├ params: ZEND_AST_PARAM_LIST └ body: ZEND_AST_STMT_LIST └ stmt[0]: ZEND_AST_RETURN └ expr: ZEND_AST_CALL ├ callable: ZEND_AST_ZVAL("random_int") returnに対応する `ZEND_AST_RETURN`なら └ args: ZEND_AST_ARG_LIST が担当 ├ arg[0]:`zend_compile_return()` ZEND_AST_ZVAL(1) └ arg[1]: ZEND_AST_ZVAL(100)
105. 105 オペコード 0000 INIT_FCALL 2 112 string("random_int") 0001 SEND_VAL int(1) 1 0002 SEND_VAL int(100) 2 0003 V0 = DO_ICALL 通常の関数に対して 0004 RETURN V0 生成されたオペコード 0005 RETURN null
106. 106 オペコード 0000 GENERATOR_CREATE 0001 INIT_FCALL 2 112 string("random_int") 0002 SEND_VAL int(1) 1 0003 SEND_VAL int(100) 2 0004 V0 = DO_ICALL ジェネレータ関数の 0005 YIELD V0 オペコード 0006 GENERATOR_RETURN null
107. 107 オペコード 0000 GENERATOR_CREATE 0001 INIT_FCALL 2 112 string("random_int") 0002 SEND_VAL int(1) 1 明らかに通常の関数とは 0003 SEND_VAL int(100) 2 別のコードが現れた 0004 V0 = DO_ICALL 0005 YIELD V0 0006 GENERATOR_RETURN null
108. 108 どこで関数/ジェネレータ関数を区別しているか `ZEND_AST_FUNC_DECL`ノードを見ただけでは、 (= そのサブノードを見ていない状態で) 自分が「どっちの関数か？」は判断できないはず・・・ なぜ、オペコードを出し分けられているのか？？？
109. 109 どこで関数/ジェネレータ関数を区別しているか 実は、重要な仕掛けは 「ASTの走査」よりも手前のフェーズにある ここ大事 <?php class A { ————— ————— ソースコード <?php T_OPEN_TAG if T_IF \s T_WHITESPACE $a T_VARIABLE \s T_WHITESPACE echo T_ECHO $x T_VARIABLE トークン S E Op E var AST val 0 1 2 3 4 5 INIT_FCALL 'hoge' SEND_VAL 1 SEND_VAL 10 DO_ICALL $0 ECHO $0 RETURN 1 オペコード 00110000 00100000 00100000 01001001 01001110 01001001 01010100 01011111 01000110 01000011 01000001 01001100 01001100 00100000 00100111 01101000 01101111 01100111 01100101 00100111 00001010 00110001 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00001010 00110010 00100000 00100000 01010011 01000101 01001110 01000100 01011111 01010110 01000001 01001100 00100000 00100000 00100000 00110001 00110000 00001010 00110011 00100000 機械語
110. 110 パース処理(zend_language_parser.y) T_YIELD expr { $$ = zend_ast_create(ZEND_AST_YIELD, $2, NULL); CG(extra_fn_flags) |= ZEND_ACC_GENERATOR; } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
111. 111 パース処理(zend_language_parser.y) `yield <expression>` が来たら T_YIELD expr { $$ = zend_ast_create(ZEND_AST_YIELD, $2, NULL); CG(extra_fn_flags) |= ZEND_ACC_GENERATOR; } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
112. 112 パース処理(zend_language_parser.y) 何かゴニョる T_YIELD expr { $$ = zend_ast_create(ZEND_AST_YIELD, $2, NULL); CG(extra_fn_flags) |= ZEND_ACC_GENERATOR; } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
113. 113 パース処理(zend_language_parser.y) ノード`ZEND_AST_YIELD`を生成して 「戻り値」にセットする T_YIELD expr { $$ = zend_ast_create(ZEND_AST_YIELD, $2, NULL); CG(extra_fn_flags) |= ZEND_ACC_GENERATOR; } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
114. 114 パース処理(zend_language_parser.y) (こっちが注目したいポイント) コンパイラのグローバル管理の値に T_YIELD expr { $$ = zend_ast_create(ZEND_AST_YIELD, $2, NULL); CG(extra_fn_flags) |= ZEND_ACC_GENERATOR; } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
115. 115 パース処理(zend_language_parser.y) (こっちが注目したいポイント) ジェネレータを示すフラグをセット T_YIELD expr { $$ = zend_ast_create(ZEND_AST_YIELD, $2, NULL); CG(extra_fn_flags) |= ZEND_ACC_GENERATOR; } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
116. 116 コンパイルの中身 if ( CG(active_op_array)->fn_flags & ZEND_ACC_GENERATOR ) { zend_mark_function_as_generator(); zend_emit_op( NULL, ZEND_GENERATOR_CREATE, NULL, `zend_compile_func_decl()` から NULL 到達してくる処理の中で ); } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
117. 117 コンパイルの中身 if ( CG(active_op_array)->fn_flags & ZEND_ACC_GENERATOR ) { zend_mark_function_as_generator(); `ZEND_ACC_GENERATOR` フラグが zend_emit_op( 立っていたら NULL, ZEND_GENERATOR_CREATE, NULL, NULL ); } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
118. 118 コンパイルの中身 if ( CG(active_op_array)->fn_flags & ZEND_ACC_GENERATOR ) { zend_mark_function_as_generator(); zend_emit_op( NULL, ジェネレータ関数を示す ZEND_GENERATOR_CREATE, オペコードを出力する NULL, NULL ); } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_language_parser.y#L1382-L1385>
119. 119 オペコード 0000 GENERATOR_CREATE 0001 INIT_FCALL 2 112 string("random_int") 0002 SEND_VAL int(1) 1 0003 SEND_VAL int(100) 2 再掲: 0004 V0 = DO_ICALL できあがりの風景 0005 YIELD V0 0006 GENERATOR_RETURN null
120. 1. yield/generator/iteratorのおさらい 2. 文法や機能など、基本的な使い方✔ DONE 3. 導入された背景やねらいなど、歴史 4. PHPの内部で何をしているのか、実装 #phpcon #track2
121. おしまいに #phpcon #track2
122. 122 こんな事を話しました • yield, yield from, current(), next(), send() • ジェネレータ、イテレータ、停止、再開 • PHPのジェネレータは、生まれた時から送受信 • 関数っぽいけどフラグを立てて独自処理が入るジェネレータ関数 普通のオブジェクトっぽいけど少し拡張されるGenerator構造体
123. 123 ★☆ 本日のテーマ☆★ yieldやGeneratorと 顔見知りになろう
124. 124 なれましたかね？？
125. 125 この時間を境に 「意外と使えるかも」 となったら幸い 濫用はNO！
126. おしまい！ お付き合いいただき ありがとうございました!!
127. Appendix 参考リソース #phpcon #track2
128. 128 Webにある記事etc • RFCでも参照されていた、ジェネレータ・コルーチンに関するプ レゼンテーション(Python畑) • https://www.dabeaz.com/generators/ • https://www.dabeaz.com/coroutines/ • 実装者(nikicさん)による、PHPのジェネレータでの協調的マルチ タスクの実装コンセンプトの紹介記事 • https://www.npopov.com/2012/12/22/Cooperative-multitaskingusing-coroutines-in-PHP.html
129. 129 PHP5.5 / 7.0リリース当時の記事など • PHP5.5新機能「ジェネレータ」初心者入門 https://www.slideshare.net/slideshow/php55/14301315 • PHP7調査(24)ジェネレータがyield fromとreturnをサポート #PHP - Qiita https://qiita.com/hnw/items/fb9bff53987978b11dde • PHP5.5のジェネレータをSPLのイテレータと組み合わせてみる hnwの日記 https://hnw.hatenablog.com/entry/20130114
130. 130 発展的な内容 • PHPにおけるI/O多重化とyield https://www.slideshare.net/slideshow/phpioyieldphpcon2014/40136098 • PHP 5.5 yield and promises - Speaker Deck https://speakerdeck.com/kaja47/php-5-dot-5-yield-andpromises
131. 131 利用方法よりの話 • Iteratorをimplementsする奴は情弱。IteratorAggregateを使え #PHP - Qiita https://qiita.com/Hiraku/items/14722922441f9ed3fbbb • 個人的にも、IteratorAggregateとの組み合わせは良さそうだなーと 思っています • PHP Generators - A useful example | Mark Story https://mark-story.com/posts/view/php-generators-a-usefulexample
132. 132 PHPの内部処理について • 「AST」「オペコード」といった概念に触れましたが、 その辺りの話題に関する発表を過去にしています • ソースコード→AST→オペコード、の旅を覗いてみる - Speaker Deck https://speakerdeck.com/o0h/phpcon-kagawa-2026
133. Appendix-Ⅱ 「1章 yield/generator/iteratorのおさらい」の 補強・補足スライド #phpcon #track2
134. 134 yieldとGenerator function nanika2() { yield 100; } var_dump(nanika2()); object(Generator)#1 (1) { ["function"]=> string(7) "nanika2" } おさらい: yieldを使うと Generatorができる
135. 135 GeneratorクラスのAPI Generatorクラスが持っているAPI(メソッド)は、 Iteratorインターフェイスの機能の他に主に3つ 1. send($value) 2. getReturn() 3. throw($exception)
136. 136 GeneratorクラスのAPI あなたは何者？ どこから来たの？？
137. Generator クラス
138. 138 さっき見たスライド function nanika2() { yield 100; } var_dump(nanika2()); object(Generator)#1 (1) { ["function"]=> string(7) "nanika2" }
139. 139 Generatorクラスとは何者か、どこから来るのか • 通常の `function` は、 `return` を0個以上含むが • そこに、(AND|OR) `yield` を含む場合には • 呼び出し時に、値を返す代わりにGeneratorオブジェクトを返す 最初の不思議ポイントかも
140. 140 強引なイメージによる説明(※正しくない) function nanikaX() { yield ▪▪▪; } $g = nanikaX(); このコードは・・・
141. 141 強引なイメージによる説明(※正しくない) function nanikaX() { return new Generator(▪▪▪); } $g = nanikaX(); 「オブジェクトを生成する」 という側面だけで言うなら、 まずは、 こんな風に捉えると良いかも
142. 142 強引なイメージによる説明(※正しくない) `Generator`は 特殊なクラスであり、 `new`で作れない。 `yield`の利用が 唯一の方法となる <https://php.net/generator>
143. 143 強引なイメージによる説明(※正しくない) • 他にも、 yieldは「単にオブジェクトを作るだけ」ではない点が 正しくないポイント • 後で触れていきます！
144. ジェネレータ
145. 145 値を(次々と生成して)呼び出し元に渡すやつ！ <https://ja.wikipedia.org/wiki/ジェネレータ_(プログラミング)>
146. 146 シンプルなイテレータを簡単に作れるやつ！！ <https://php.net/generators.overview>
147. 147 ？ ？ ?が2つ浮かんできます シンプルなイテレータを簡単に作れるやつ！！ <https://php.net/generators.overview>
148. イテレータ ─そして、それは簡単に作れないのか─
149. 149 iterate【動詞】 • 繰り返す、反復する • repeat が「同じ事を繰り返す」のに対して、 「順番に進める」「逐次的に処理する」ようなニュアンス
150. 150 イテレータ = 繰り返せるもの • 「イテレータパターン」、有名ですね • 集約オブジェクトに関して、 (利用者側が詳しく内部構造を知らなくても) 適切な順番で要素を取り出せるようにするパターン
151. 151 反復の処理をしよう for ($i=0; $i < 10; $i++) { $item = $data[$i]; // nanika shori... } 例えば、コレも反復処理
152. 152 反復の処理をしよう for ($i=0; $i < 10; $i++) { $item = $data[$i]; // nanika shori... } これで上手くいくには 「データの長さは10である」 「キーが0〜9の連番である」 ことを、 事前に知っておかないとダメ
153. 153 反復の処理をしよう $data = [ 'a' => true, 'b' => false, 'c' => true, ]; for($i=0; $i < 10; $i++){ $item = $data[$i]; // nanika shori... } こういうのには通用しない
154. 154 反復の処理をしよう $keys = array_keys($data); $len = count($keys); for($i=0; $i<$len; $i++) { $key = $keys[$i]; $item = $data[$k]; // nanika shori... } これで大丈夫 (面倒くさいですね)
155. 155 イテレータパターン • 利用者側が、内部構造(キーや要素数)を知らなくても良くする • (すごくザックリ言うと) 「まだありますか」「次をください」に応えられるようにする
156. 156 イテレータパターン while ($data->hasNext()) { $item = $data->getNext(); // nanika shori... } これで大丈夫 (簡単になりましたね！)
157. 157 PHPと反復処理 iterable(疑似型) Traversable Iterator PHPにおける 反復処理の対応 array 「foreachに渡せる」もの と覚えればOK IteratorAggregate
158. 158 PHPと反復処理 iterable(疑似型) 言い換えると、 「オブジェクトをforeach Traversable array で使う」には 特定Interfaceの実装クラ スが必要 Iterator IteratorAggregate
159. 159 思い出す <https://php.net/generators.overview>
160. 160 IteratorインターフェイスのAPI(契約) interface Iterator extends Traversable { public function current(): mixed public function key(): mixed public function next(): void public function rewind(): void public function valid(): bool } 6つのメソッドを用意しないといけない
161. 161 Iteratorの実装例 $iterator = new class($data) implements Iterator { private array $keys; private int $position = 0; private array $data = ['a' => true, 'b' => false, 'c' => true]; public function __construct() { $this->keys = array_keys($this->data); } public function rewind(): void { $this->position = 0; } public function valid(): bool { return isset($this->keys[$this->position]); } public function current(): mixed { return $this->data[$this->keys[$this->position]]; } public function key(): mixed { return $this->keys[$this->position]; } public function next(): void { $this->position++; } }; Iterator実装を用意する オーバーヘッドや煩わしさ
162. 162 Iteratorの実装例 $generator = (function() { yield 'a' => true; yield 'b' => false; yield 'c' => true; })(); yieldなら、これだけで 「順番に値を返す」機能が 提供される
163. 163 ？ ？ 浮かんできた2つの「？」 これで解消できたを シンプルなイテレータを簡単に作れるやつ！！ <https://php.net/generators.overview>
164. ✔ DONE 1. yield/generator/iteratorのおさらい #phpcon #track2
165. Appendix-Ⅲ 「2章 文法や機能など、基本的な使い方」の 補強・補足スライド #phpcon #track2
166. Generator::send() Generator::throw()
167. 167 yieldの「受信」機能 function generator() { yield 'a'; yield 'b'; yield 'c'; } `yield` は 「処理を止めて」 「値を返す」、 もしくは「再開地点」 という話をしましたが・・
168. 168 yieldの「受信」機能 function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
169. 169 yieldの「受信」機能 function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } `send($value)` = 値を送って、次の停止位置まで進める: $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); コレまで見てきたものは 「右にある式の結果」を使ったが、 echo "current: [{$g->current()}]\n"; 「外から値を渡して、左側に渡す」動きになる $g->send('BBB'); echo "current: [{$g->current()}"]\n";
170. 170 yieldの「受信」機能 function generator() { (初期状態なので、最初の) $x = yield 'a'; 停止位置まで進ませ、 呼び出し元に `a`を返す var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
171. 171 yieldの「受信」機能 function generator() { 現在位置の`yield`に $x = yield 'a'; 引数`AAA`を入れて、 var_dump("received: x={$x}"); 左に返す $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n"; つまり、 `$x = 'AAA';` として 処理が進む
172. 172 yieldの「受信」機能 function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; `next()`と同じ様に var_dump("received: x={$x}, y={$y}"); 次の停止位置まで進める } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
173. 173 yieldの「受信」機能 string(15) "received: x=AAA" function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
174. 174 yieldの「受信」機能 function generator() { $x = yield 'a'; var_dump("received: x={$x}"); ここで停止 $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
175. 175 yieldの「受信」機能 function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } 現在の値を返す => echo (current: [b]) $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
176. 176 yieldの「受信」機能 function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; `BBB`を渡して、次の停止位置まで進める $g->send('AAA'); echo "current: [{$g->current()}]\n"; よって、var_dumpまで処理。 $g->send('BBB'); => string(22) "received: x=AAA, y=BBB" echo "current: [{$g->current()}"]\n";
177. 177 yieldに例外も送り込める function generator() { try { yield; } catch (\LogicException $e) { `throw ($exception)` var_dump($e->getMessage()); =停止位置から、任意の例外を投げさせる: } } つまり、yieldの部分を throw 文に置き換えるようなイメージになる $g = generator(); $g->throw( new \LogicException('dou desu ka?') );
178. 178 yieldに例外も送り込める function generator() { try { yield; } catch (\LogicException $e) { var_dump($e->getMessage()); } } string(12) "dou desu ka?" $g = generator(); $g->throw( new \LogicException('dou desu ka?') );
179. Generator::getReturn()
180. 180 generator関数のreturn対応 function generator() { foreach([1, 100, 1000] as $v) { yield $v; } return 'done!'; } `getReturn()` =戻り値を取得する: $g = generator(); foreach ($g as $v) { /** nanka suru */} 関数内の `return` の値を取得する var_dump($g->current()); var_dump($g->getReturn())
181. 181 generator関数のreturn対応 function generator() { foreach([1, 100, 1000] as $v) { yield $v; } return 'done!'; } $g = generator(); foreach ($g as $v) { /** nanka suru */} NULL string(5) "done!" var_dump($g->current()); var_dump($g->getReturn())
182. 182 generator関数のreturn対応 function generator() { yield 1; yield 2; return 'done!'; } $g = generator(); $g->next(); var_dump($g->getReturn()); まだ`return` に 到達していない状態だと・・
183. 183 generator関数のreturn対応 function generator() { yield 1; yield 2; return 'done!'; メソッド呼び出し時に例外を投げる => Fatal error: Uncaught Exception: Cannot get return } value of a generator that hasn't returned in XXX $g = generator(); $g->next(); var_dump($g->getReturn());
184. yield from
185. 185 ジェネレータの「委譲」 function generator() { yield from [1, 2, 3]; yield 100; } $g = generator(); foreach ($g as $v) { var_dump($v); } `yield from` = 別のiterableから値をyieldする: 処理を委譲する・ジェネレータを合成する、 という感じに
186. 186 ジェネレータの「委譲」 function generator() { yield from [1, 2, 3]; yield 100; } $g = generator(); foreach ($g as $v) { var_dump($v); } int(1) int(2) int(3) int(100)
187. ✔ DONE 2. 文法や機能など、基本的な使い方 #phpcon #track2
188. Appendix-Ⅳ 「3章導入された背景やねらいなど、歴史」の 補強・補足スライド #phpcon #track2
189. 発表では 割愛した部分！ PHP: rfc:generators
190. 190 <https://wiki.php.net/rfc/generators>
191. 191 「値を返す」だけではなくて 「受け取り」も可能になる(する) 「拡張された」、「反対方向の」ジェネーレータとか コルーチンとか呼ばれるような機能 <https://wiki.php.net/rfc/generators>
192. 192 ※補足: yieldの「受信」ってこんなやつです function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
193. 193 ※補足: yieldの「受信」ってこんなやつです function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } `send($value)` = 値を送って、次の停止位置まで進める: $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); コレまで見てきたものは 「右にある式の結果」を使ったが、 echo "current: [{$g->current()}]\n"; 「外から値を渡して、左側に渡す」動きになる $g->send('BBB'); echo "current: [{$g->current()}"]\n";
194. 194 ※補足: yieldの「受信」ってこんなやつです string(15) "received: x=AAA" function generator() { $x = yield 'a'; var_dump("received: x={$x}"); $y = yield 'b'; var_dump("received: x={$x}, y={$y}"); } $g = generator(); echo "current: [{$g->current()}]\n"; $g->send('AAA'); echo "current: [{$g->current()}]\n"; $g->send('BBB'); echo "current: [{$g->current()}"]\n";
195. 195 なぜ 「受信」が入ったのか・・？ • 正直な所、「簡単に使えるイテレータを」に比べて 「sendが欲しい」動機をしっかりと読み取れなかった・・ • 技術的には、「next()を入れるなら、send()も近い実装になる」 • `send(null)` を、そのまま `next()` として使えば良いので
196. なぜ `send()` `throw()`が入ったのか・・？ • 恐らく、Pythonのジェネレータ/yieldの影響が大きい • Pythonでは、 1. 最初に「値を返すだけ」のジェネレータが実装されて 2. その後に、「値を受け取って再開」の機能が実装されている • 時系列的に、PHP側は↑の「2」まで進んだ後のRFCであり 設計としても進化の道筋としても、 参考になっているのではないか 196
197. 197 RFC上でも、 関連リソースとして 直接Pythonでの話が 言及されていたり <https://wiki.php.net/rfc/generators>
198. 198 php-srcへのコミットにも Pythonへの言及があったり <https://github.com/php/php-src/pull/177/changes/3600914ced52eb4f6db10410ba887c8e2a2acfe1>
199. PHP: rfc:generator-return-expressions PHP: rfc:generator-delegation
200. 200 2つのRFC • `yield from` と、「ジェネレータ関数のreturn対応」は 同じモチベーションを元に、分割して提出されている • コルーチンとしての特徴を活かして、協調的マルチタスクを・・ というのが共通ゴール
201. 201 Generator Delegation • 複雑な処理を行う関数を分割(リファクタ)するように、 ジェネレータも分割したい！ • そこで、「委譲処理」を可能にしよう • 生まれたのが`yield from` 記法/機能
202. 202 Generator Return Expressions • (委譲によって) ジェネレータ内から、別のジェネレータを呼べるようになった • 逆に言えば、 「子ジェネレータが終わったのを、どう処理するか」問題 `yield from` で受け取った値は、「委譲元」ではなく「委譲元の呼び 出し元」に渡ってしまう(パススルー) • 値を引き継げないし、終了判定も難しい、すると「協調」しにくい・・ • • `return` を使えるようにすることで、これらの問題を解決
203. ✔ DONE 3. 導入された背景やねらいなど、歴史 #phpcon #track2
204. Appendix-Ⅴ 「4章 PHPの内部で何をしているのか、実装」の 補強・補足スライド #phpcon #track2
205. どうやって「値の受け取り」をしているのか
206. 206 Generatorが持つ特別な値(フィールド) (通常のクラスのインスタンスのような)オブジェクトに加えて、 Generatorの特殊能力を実現するために持っているものがある • 現在の停止位置(オペコード上の何行目か) • `key()` `current()` で返すための値 • etc
207. 207 Generatorが持つ特別な値(フィールド) その1つに、 「`send($v)` された時に、その値をどこに格納するか」 という情報も持っている
208. 208 Generatorの構造体 struct _zend_generator { zend_object std; zend_execute_data *execute_data; zend_execute_data *frozen_call_stack; zval value; zval key; これが zval retval; 「`send()`の受け口」 zval *send_target; の保持場所 <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_generators.h#L57C8-L96>
209. 209 *send_targetの利用(セットアップ) yield式の処理の一部 if (RETURN_VALUE_USED(opline)) { generator->send_target = EX_VAR(opline->result.var); ZVAL_NULL(generator->send_target); } else { generator->send_target = NULL; } <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_vm_def.h#L8544-L8551>
210. 210 *send_targetの利用(セットアップ) if (RETURN_VALUE_USED(opline)) { generator->send_target = EX_VAR(opline->result.var); ZVAL_NULL(generator->send_target); yield式の } else { generator->send_target = NULL; 返り値が使われていたら } つまり、 `$x = yield`みたいな <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_vm_def.h#L8544-L8551>
211. 211 *send_targetの利用(セットアップ) if (RETURN_VALUE_USED(opline)) { generator->send_target = EX_VAR(opline->result.var); ZVAL_NULL(generator->send_target); } else { yield式の代入先(左辺)のポインタを generator->send_target = NULL; } send_targetにセット つまり、 `$x = yield`の `$x` <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_vm_def.h#L8544-L8551>
212. 212 Generator::send()の処理 `send()` ZEND_METHOD(Generator, send) { (中略) メソッドのコード root = zend_generator_get_current(generator); if (root->send_target && !(root->flags & ZEND_GENERATOR_CURRENTLY_RUNNING)) { ZVAL_COPY(root->send_target, value); } zend_generator_resume(generator); <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_generators.c#L998-L1030>
213. 213 Generator::send()の処理 ZEND_METHOD(Generator, send) { (中略) `send_target` が設定されていたら root = zend_generator_get_current(generator); if (root->send_target && !(root->flags & ZEND_GENERATOR_CURRENTLY_RUNNING)) { ZVAL_COPY(root->send_target, value); } zend_generator_resume(generator); <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_generators.c#L998-L1030>
214. 214 Generator::send()の処理 ZEND_METHOD(Generator, send) { (中略) root = zend_generator_get_current(generator); if (root->send_target && 送られてきたvalueをセットして !(root->flags & ZEND_GENERATOR_CURRENTLY_RUNNING)) { ZVAL_COPY(root->send_target, value); } zend_generator_resume(generator); <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_generators.c#L998-L1030>
215. 215 Generator::send()の処理 ZEND_METHOD(Generator, send) { (中略) root = zend_generator_get_current(generator); if (root->send_target && !(root->flags & ZEND_GENERATOR_CURRENTLY_RUNNING)) { ZVAL_COPY(root->send_target, value); 処理を再開(resume)する } zend_generator_resume(generator); <https://github.com/php/php-src/blob/fe52e5b6/Zend/zend_generators.c#L998-L1030>
216. ✔ DONE 5. PHPの内部で何をしているのか、実装 #phpcon #track2