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

isInternalメソッドは、ReflectionFunctionAbstractクラスに属し、特定の関数やメソッドがPHPの内部で定義されているものかを確認するメソッドです。このメソッドは、私たちがPHPコード内で独自に定義した関数やメソッド（ユーザー定義）と、PHPのコアや標準拡張モジュールによって提供される、あらかじめPHPに組み込まれている関数やメソッド（内部定義）を区別するために使用されます。

具体的には、strlen()やarray_push()のようにPHPが標準で提供する機能は「内部で定義されている」と判断されます。一方、私たちがスクリプト内でfunction myFunction() { ... }のように定義したものは「ユーザー定義」と判断されます。

このメソッドは、関数やメソッドが内部で定義されている場合にtrueを返し、ユーザー定義である場合にfalseを返します。プログラムが実行時に動的に関数やメソッドに関する情報を取得する際、その起源がPHPの組み込み機能なのか、それとも開発者によって定義されたものなのかを判別したい場合に特に役立ちます。例えば、コード解析ツールやデバッグツールを開発する際に、この情報に基づいて処理を分岐させたい場面で活用されます。

Copy
1<?php
2// 内部関数 'strlen' のReflectionFunctionオブジェクトを作成
3$reflectionInternal = new ReflectionFunction('strlen');
4// isInternal()メソッドを呼び出し、それがPHPの内部関数であるかを確認
5var_dump($reflectionInternal->isInternal());
6
7// ユーザー定義関数 'myCustomFunction' のReflectionFunctionオブジェクトを作成
8function myCustomFunction() {}
9$reflectionCustom = new ReflectionFunction('myCustomFunction');
10// isInternal()メソッドを呼び出し、それがPHPの内部関数であるかを確認
11var_dump($reflectionCustom->isInternal());
12?>

引数なし

引数はありません

bool

このメソッドは、ReflectionFunctionAbstract オブジェクトが内部関数（PHP の組み込み関数など）を参照している場合に true を返します。それ以外の場合は false を返します。