【PHP8.x】suspendメソッドの使い方

Copy
1<?php
2
3/**
4 * Fiber::suspend() の使用例
5 */
6
7function createFiber(): Fiber
8{
9    return new Fiber(function (string $name): string {
10        echo "Fiber started with name: $name\n";
11        $value = Fiber::suspend("Initial suspend");
12        echo "Fiber resumed with value: $value\n";
13        $value = Fiber::suspend("Second suspend");
14        echo "Fiber completed with value: $value\n";
15        return "Fiber finished";
16    });
17}
18
19$fiber = createFiber();
20
21// ファイバーを開始し、最初の suspend まで実行
22$result1 = $fiber->start("MyFiber");
23echo "Main context received: $result1\n";
24
25// ファイバーを再開し、次の suspend まで実行
26$result2 = $fiber->resume("First resume value");
27echo "Main context received: $result2\n";
28
29// ファイバーを再開し、実行を完了
30$result3 = $fiber->resume("Second resume value");
31echo "Main context received: $result3\n";
32echo "Fiber is dead: " . ($fiber->isTerminated() ? 'true' : 'false') . "\n";
33echo "Fiber return value: " . $fiber->getReturn() . "\n";

PHP 8のFiberクラスにおけるsuspend()メソッドは、ファイバーの実行を一時停止し、指定された値を呼び出し元に返します。引数$valueは省略可能で、一時停止時に渡す値を指定します。省略した場合はNULLが渡されます。このメソッドの戻り値は、ファイバーが再開された際にresume()メソッドに渡された値です。

サンプルコードでは、createFiber()関数内で新しいFiberオブジェクトを作成しています。このファイバーは、開始時に文字列$nameを受け取り、suspend()メソッドを2回呼び出して実行を一時停止します。それぞれのsuspend()の呼び出しで、異なる文字列が返されます。

メインの処理では、まずcreateFiber()でファイバーを作成し、start()メソッドでファイバーを開始します。start()メソッドに渡された"MyFiber"がファイバーに渡され、最初のsuspend()が実行されると、"Initial suspend"がメインコンテキストに返されます。次に、resume()メソッドを使ってファイバーを再開します。resume()メソッドに渡された"First resume value"がファイバーに渡され、次のsuspend()が実行されると、"Second suspend"がメインコンテキストに返されます。最後に、再度resume()メソッドを呼び出し、"Second resume value"をファイバーに渡します。ファイバーは処理を完了し、"Fiber finished"を返します。

isTerminated()メソッドでファイバーが終了したかを確認し、getReturn()メソッドでファイバーの戻り値を取得しています。この例では、suspend()メソッドを使用することで、ファイバーの実行を制御し、メインの処理との間で値を交換する方法を示しています。