【PHP8.x】ReflectionFiber::getFiber()メソッドの使い方

getFiberメソッドの使い方について、初心者にもわかりやすく解説します。

作成日: 2025年09月11日更新日: 2026年01月31日

基本的な使い方

getFiberメソッドは、ReflectionFiberクラスに属し、そのReflectionFiberオブジェクトが表す実際のFiberオブジェクトを取得するメソッドです。PHP 8.1で導入されたFiberは、プログラム内で協調的に動作する軽量なコルーチンを実現する機能です。ReflectionFiberクラスは、実行中のFiberの状態や情報をプログラムから詳細に検査するために使用されます。

このgetFiberメソッドは、特定のReflectionFiberオブジェクトが指し示している元のFiberインスタンスそのものにアクセスすることを目的としています。引数を必要とせず、呼び出すと、対応するFiberオブジェクトが戻り値として返されます。

例えば、ReflectionFiberオブジェクトを使ってFiberの現在の状態（実行中、中断中、終了済みなど）を確認した後、そのFiberオブジェクトを取得して、resume()メソッドで実行を再開したり、throw()メソッドで例外を投入したりといった、実際のFiberへの操作を行う場面でこのメソッドが役立ちます。ReflectionFiberによって得られた情報に基づいて、元のFiberインスタンスを直接操作したい場合に利用する、非常に重要なインターフェースです。

構文(syntax)


1<?php
2
3// Fiberオブジェクトを準備する
4$fiber = new Fiber(function () { /* Fiberの処理 */ });
5
6// ReflectionFiberオブジェクトを作成する
7$reflectionFiber = new ReflectionFiber($fiber);
8
9// getFiberメソッドを呼び出して元のFiberオブジェクトを取得する
10$originalFiber = $reflectionFiber->getFiber();

引数(parameters)

引数なし

引数はありません

戻り値(return)

Fiber

ReflectionFiber::getFiber() は、ReflectionFiber インスタンスがラップしている Fiber オブジェクトを返します。