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

isUserDefinedメソッドは、指定されたオブジェクトが開発者によって独自に定義された（ユーザー定義の）クラスのインスタンスであるかどうかを判定するメソッドです。

このメソッドは、PHPのリフレクションAPIの一部であるReflectionObjectクラスに属しています。リフレクションAPIは、実行中のプログラムが自身の構造（クラス、メソッド、プロパティなど）を検査・変更できるようにする機能を提供します。isUserDefinedメソッドを呼び出すことで、特定のオブジェクトが、PHPのコアや標準拡張機能によって提供される組み込みクラス（例えば、DateTimeやstdClassなど）のインスタンスであるのか、それともアプリケーション開発者がコード内で独自に作成したクラスのインスタンスであるのかを判別できます。

具体的には、このメソッドは、対象のオブジェクトが開発者が書いたPHPスクリプト内で定義されたクラスに由来する場合にブール値のtrueを返します。一方、オブジェクトがPHPの内部で定義されたクラスや、PHPの各種拡張機能によって提供されるクラスのインスタンスである場合にはfalseを返します。

この機能は、特にフレームワークやライブラリを開発する際に役立ちます。例えば、処理の対象となるオブジェクトが、システム内部で定義された特定の型であるか、あるいは外部から注入されたユーザー独自の型であるかによって、動的に処理を分岐させたい場合に活用できます。オブジェクトの出所を正確に識別することで、より柔軟で安全なプログラム設計に貢献します。

Copy
1<?php
2class MyExampleClass {}
3$object = new MyExampleClass();
4$reflector = new ReflectionObject($object);
5$reflector->isUserDefined();

引数なし

引数はありません

bool

ReflectionObject::isUserDefined() は、そのオブジェクトがユーザー定義されたものである場合に true を、組み込みのものである場合に false を返します。