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

getClosureCalledClassメソッドは、PHPのReflection APIの一部であるReflectionMethodクラスに属し、クロージャとしてバインドされたメソッドが、どのクラスのコンテキストで呼び出されるべきかを特定する際に使用されるメソッドです。このメソッドは、特にPHP 8.0以降で導入されました。

具体的には、あるクラスのメソッドがクロージャ（匿名関数）として変換され、その後、そのクロージャが呼び出される際に、どのクラスを「呼び出し元」として扱うかを調べたい場合に利用されます。たとえば、Closure::fromCallable()関数を使ってクラスメソッドからクロージャを生成した場合、そのクロージャは元のクラスメソッドのコンテキストを保持しています。getClosureCalledClassメソッドは、このクロージャがもしメソッドとして実行された場合に、selfやparent、staticといったキーワードがどのクラスを指すことになるのかを表すReflectionClassオブジェクトを返します。

もしクロージャが特定のクラスにバインドされていない場合や、呼び出し元のクラスが特定できない場合には、このメソッドはnullを返します。この機能は、フレームワークやライブラリ開発において、実行時にコードの振る舞いを動的に解析し、クロージャの持つスコープ情報を詳細に把握する必要があるような、高度なリフレクション処理を行う際に役立ちます。

Copy
1<?php
2
3class MyClass
4{
5    public function myMethod()
6    {
7        // ...
8    }
9}
10
11$reflector = new ReflectionMethod(MyClass::class, 'myMethod');
12$calledClass = $reflector->getClosureCalledClass();

引数なし

引数はありません

ReflectionClass|null

このメソッドは、ReflectionMethod インスタンスが表すメソッドがクロージャとして呼び出された場合に、そのクロージャが実行されたクラスの ReflectionClass インスタンスを返します。メソッドがクロージャとして呼び出されなかった場合は null を返します。