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

Copy
1<?php
2
3// PHPにおける関数のリフレクション（情報を取得すること）の例です。
4// ReflectionFunction::isStatic() メソッドを使って、関数が静的であるかを判別します。
5// PHPでは、グローバルスコープで定義される通常の関数は「静的」という概念を持ちません。
6// このメソッドが true を返すのは、主に 'static' キーワードで定義された無名関数（クロージャ）です。
7
8// 1. 通常のグローバル関数
9// グローバル関数は static キーワードで定義できません。
10function sayHello(string $name): void
11{
12    echo "こんにちは、" . $name . "さん！\n";
13}
14
15// 2. 通常の無名関数（クロージャ）
16// クロージャは、定義されたスコープの変数を 'use' キーワードで取り込むことができます。
17$regularClosure = function (): void {
18    echo "これは通常のクロージャ（無名関数）です。\n";
19};
20
21// 3. 静的な無名関数（クロージャ）
22// 'static' キーワードで定義されたクロージャは、外側のスコープの変数を
23// 'use' キーワードで取り込むことができません。これは性能面や意図の明確化に役立ちます。
24$staticClosure = static function (): void {
25    echo "これは静的なクロージャ（無名関数）です。\n";
26};
27
28echo "--- ReflectionFunction::isStatic() の結果 ---\n";
29
30// グローバル関数の isStatic() をチェック
31// ReflectionFunction のコンストラクタには、関数名を文字列で渡します。
32$reflectionSayHello = new ReflectionFunction('sayHello');
33echo "関数 'sayHello' は静的ですか？ "
34    . ($reflectionSayHello->isStatic() ? 'はい' : 'いいえ')
35    . " (グローバル関数は静的ではありません)\n";
36
37// 通常のクロージャの isStatic() をチェック
38// ReflectionFunction のコンストラクタには、クロージャオブジェクトを直接渡します。
39$reflectionRegularClosure = new ReflectionFunction($regularClosure);
40echo "クロージャ 'regularClosure' は静的ですか？ "
41    . ($reflectionRegularClosure->isStatic() ? 'はい' : 'いいえ')
42    . " (通常のクロージャは静的ではありません)\n";
43
44// 静的なクロージャの isStatic() をチェック
45$reflectionStaticClosure = new ReflectionFunction($staticClosure);
46echo "クロージャ 'staticClosure' は静的ですか？ "
47    . ($reflectionStaticClosure->isStatic() ? 'はい' : 'いいえ')
48    . " (static キーワードで定義されたクロージャは静的と判定されます)\n";
49
50?>

ReflectionFunction::isStatic()メソッドは、PHPの関数が「静的（static）」であるかを判定します。このメソッドは引数を取らず、関数の静的属性を真偽値（trueまたはfalse）で返します。

PHPにおける「静的関数」とは、主にstaticキーワードで定義された無名関数（静的なクロージャ）を指します。通常のグローバル関数やstaticキーワードが付かない無名関数は静的ではないため、isStatic()を呼び出すとfalseが返されます。

サンプルコードの通り、static function() { ... } の形式で定義されたクロージャのみが静的と判定され、isStatic()はtrueを返します。静的なクロージャは、外側のスコープの変数をuseキーワードで取り込めない特性があります。このメソッドは、実行時に特定の関数の静的特性を動的に確認したい場合に利用されます。

Copy
1<?php
2
3// ReflectionFunction::isStatic() は、関数（特に無名関数であるクロージャ）が静的かどうかをチェックします。
4// PHP 8 から導入されたこのメソッドは、static キーワードで定義された静的クロージャを識別するのに役立ちます。
5// 静的クロージャは、外側のスコープの変数（$this や親スコープの変数）にアクセスしないことが保証されます。
6
7// 例1: 通常のクロージャ（非静的）
8// 外側のスコープに依存する可能性があるため、isStatic() は false を返します。
9$normalClosure = function () {
10    return "これは通常のクロージャです。";
11};
12
13// 例2: 静的クロージャ
14// static キーワードを付与することで、このクロージャが外側のスコープの変数にアクセスしないことが明示されます。
15// そのため、isStatic() は true を返します。
16$staticClosure = static function () {
17    return "これは静的クロージャです。";
18};
19
20// ReflectionFunction オブジェクトを作成し、isStatic() メソッドで静的特性をチェックします。
21$reflectionNormal = new ReflectionFunction($normalClosure);
22$reflectionStatic = new ReflectionFunction($staticClosure);
23
24echo "通常のクロージャは静的ですか？ " . ($reflectionNormal->isStatic() ? "はい" : "いいえ") . PHP_EOL;
25echo "静的クロージャは静的ですか？ " . ($reflectionStatic->isStatic() ? "はい" : "いいえ") . PHP_EOL;
26
27// クロージャを実行して結果を確認
28echo "実行結果 (通常のクロージャ): " . $normalClosure() . PHP_EOL;
29echo "実行結果 (静的クロージャ): " . $staticClosure() . PHP_EOL;
30
31?>

ReflectionFunction::isStatic() メソッドは、PHP 8で導入されたもので、特定の関数が「静的（static）」であるかどうかをチェックするために使用されます。特に、PHPにおける無名関数であるクロージャが static キーワードを使って定義されているかを判別する際に役立ちます。

このメソッドは引数を一切取りません。関数が静的に定義されていれば true を、そうでなければ false を真偽値（bool）として返します。

静的クロージャは、関数定義の先頭に static キーワードを付与することで作成されます。これにより、そのクロージャが外側のスコープの変数や $this オブジェクトにアクセスしないことが保証されます。この特性は、クロージャの振る舞いを予測しやすくし、意図しない副作用を防ぐのに役立ちます。

サンプルコードでは、まず static キーワードが付与されていない通常のクロージャと、付与された静的クロージャの二つを定義しています。次に、それぞれのクロージャを ReflectionFunction クラスのオブジェクトとしてラップし、isStatic() メソッドを呼び出しています。その結果、通常のクロージャに対しては「いいえ（false）」が、静的クロージャに対しては「はい（true）」が出力され、メソッドがクロージャの静的特性を正確に識別していることがわかります。このメソッドは、実行時にクロージャの性質をプログラムから確認したい場合に非常に有効です。