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

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

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

基本的な使い方

getExecutingFileメソッドは、ReflectionFiberオブジェクトが表すファイバーが、現在どのファイル内でコードを実行しているか、そのパスを取得するメソッドです。

このメソッドは、PHP 8で導入されたReflectionFiberクラスに属します。ReflectionFiberは、PHPのFiber（ファイバー）機能と連携し、ファイバーの内部状態を詳細に検査するためのリフレクション機能を提供します。ファイバーは、プログラムの実行を一時停止したり再開したりすることで、軽量な並行処理を実現するための仕組みです。

getExecutingFileメソッドは、ある特定のファイバーが現在どのPHPファイルを実行コンテキストとして使用しているか、そのフルパスを文字列として返します。ファイバーが一時停止している場合でも、最後に実行していたファイルのパスが取得可能です。この情報は、デバッグ時や、複数のファイバーが複雑な処理を分担しているアプリケーションにおいて、各ファイバーの実行位置を把握するために非常に有用です。これにより、プログラムの流れを追跡し、問題の原因を特定する手助けとなります。

構文(syntax)


1<?php
2
3$fiber = new Fiber(function () {
4    // このFiberが関連付けられているファイルは、このスクリプトファイル自身です。
5    // getExecutingFile メソッドは、Fiberが実行中または一時停止中のときに情報を取得できます。
6});
7
8$reflectionFiber = new ReflectionFiber($fiber);
9
10$executingFile = $reflectionFiber->getExecutingFile();
11
12// $executingFile には、Fiberのコールバックが定義されているファイルパス（例: /path/to/your/script.php）が入ります。

引数(parameters)

引数なし

引数はありません

戻り値(return)

?string

実行中のFiberが定義されているファイルパスを文字列で返します。ファイルパスが見つからない場合はnullを返します。