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

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

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

基本的な使い方

isInstanceメソッドは、ReflectionObjectクラスのインスタンスが対象としているオブジェクトが、現在有効なインスタンスとして存在するかどうかを判定するメソッドです。このメソッドは、対象のオブジェクトがまだメモリ上に存在し、操作可能な状態であれば真（true）を返します。反対に、対象のオブジェクトが既に破棄されている場合や、そもそも有効なオブジェクトとして存在しない場合には偽（false）を返します。

ReflectionObjectクラスは、PHPのオブジェクトの構造や挙動をプログラム上で詳細に調べたり操作したりするための「リフレクションAPI」の一部です。このisInstanceメソッドは、リフレクションを使ってオブジェクトのプロパティやメソッドにアクセスする前に、そのオブジェクトがまだ「生きている」ことを確認するために非常に有用です。例えば、複数の処理の中でオブジェクトのライフサイクルを管理する際や、外部からの入力によって得られたオブジェクト参照が有効であるかを検証する場面などで利用されます。これにより、存在しないオブジェクトへのアクセスによる予期せぬエラーを防ぎ、より堅牢で信頼性の高いプログラムを作成することができます。

構文(syntax)


1<?php
2
3class MySampleClass {}
4
5$object = new MySampleClass();
6
7$reflectionObject = new ReflectionObject($object);
8
9$isInstance = $reflectionObject->isInstance($object);

引数(parameters)

object $object

object $object: インスタンスかどうかをチェックする対象のオブジェクト

戻り値(return)

bool

指定されたオブジェクトが、このReflectionObjectが表すクラスのインスタンスである場合にtrueを返します。そうでない場合はfalseを返します。

サンプルコード

PHP ReflectionObject::isInstance() でインスタンスを判定する


1<?php
2
3/**
4 * サンプルで使用するクラスです。
5 */
6class MyClass
7{
8    public function __construct()
9    {
10        // クラスのコンストラクタ（今回は特に処理はありません）
11    }
12}
13
14/**
15 * 比較のために用意する別のクラスです。
16 */
17class AnotherClass
18{
19    public function __construct()
20    {
21        // クラスのコンストラクタ（今回は特に処理はありません）
22    }
23}
24
25// MyClassのインスタンスを作成します。
26$myObject = new MyClass();
27
28// AnotherClassのインスタンスを作成します。
29$anotherObject = new AnotherClass();
30
31// ReflectionObjectを使い、$myObjectのクラス（MyClass）のリフレクション情報を取得します。
32// ReflectionObjectは、実行時にオブジェクトやクラスの情報を取得・操作するための機能を提供します。
33$reflector = new ReflectionObject($myObject);
34
35echo "--- ReflectionObject::isInstance() と instanceof の比較 --- \n\n";
36
37// $myObjectがReflectionObjectが表すクラス（MyClass）のインスタンスであるかを確認します。
38// これは、$reflectorがMyClassのリフレクションであり、$myObjectもMyClassのインスタンスであるため、trueを返します。
39$isMyInstance = $reflector->isInstance($myObject);
40echo "ReflectionObject::isInstance(\$myObject) の結果: " . ($isMyInstance ? 'true' : 'false') . "\n";
41
42// 参考として、PHPの instanceof 演算子で同じチェックを行います。
43// instanceof は、オブジェクトが特定のクラスのインスタンスであるかを確認する一般的な方法です。
44$instanceofMyClass = $myObject instanceof MyClass;
45echo "(\$myObject instanceof MyClass) の結果      : " . ($instanceofMyClass ? 'true' : 'false') . "\n";
46
47echo "\n";
48
49// 次に、$anotherObjectがReflectionObjectが表すクラス（MyClass）のインスタンスであるかを確認します。
50// $anotherObjectはAnotherClassのインスタンスであるため、falseを返します。
51$isAnotherInstance = $reflector->isInstance($anotherObject);
52echo "ReflectionObject::isInstance(\$anotherObject) の結果: " . ($isAnotherInstance ? 'true' : 'false') . "\n";
53
54// instanceof 演算子でも同じチェックを行います。
55// $anotherObjectはAnotherClassのインスタンスなので、MyClassとは異なり、falseを返します。
56$instanceofAnotherClass = $anotherObject instanceof MyClass;
57echo "(\$anotherObject instanceof MyClass) の結果      : " . ($instanceofAnotherClass ? 'true' : 'false') . "\n";
58
59echo "\n";
60echo "--- 解説 ---\n";
61echo "ReflectionObject::isInstance() メソッドは、指定されたオブジェクトが、\n";
62echo "その ReflectionObject が表現しているクラス（今回の例では MyClass）の\n";
63echo "インスタンスであるかどうかを boolean 値で返します。\n";
64echo "これは instanceof 演算子と同じような機能を提供しますが、\n";
65echo "ReflectionObject を使うことで、どのクラスに対してチェックを行うかを\n";
66echo "動的に決定できるという利点があります。\n";
67

PHP 8のReflectionObject::isInstance()メソッドは、実行時にオブジェクトやクラスの情報を取得・操作する「リフレクション」機能の一部です。このメソッドは、指定されたオブジェクトが、そのReflectionObjectが表現しているクラスのインスタンスであるかどうかを真偽値（trueまたはfalse）で判定します。

引数$objectには、インスタンスであるかを確認したいオブジェクトを指定します。戻り値はbool型で、指定されたオブジェクトがReflectionObjectが表現するクラスのインスタンスであればtrueを、そうでなければfalseを返します。

サンプルコードでは、MyClassのインスタンスからReflectionObjectを作成し、$reflectorにMyClassのリフレクション情報を格納しています。$reflector->isInstance($myObject)は、$myObjectがMyClassのインスタンスであるためtrueを返します。これに対し、AnotherClassのインスタンスである$anotherObjectに対して$reflector->isInstance($anotherObject)を実行すると、MyClassのインスタンスではないためfalseが返されます。

この機能は、PHPのinstanceof演算子と同様にオブジェクトの型を確認できますが、ReflectionObject::isInstance()を使用すると、どのクラスに対してチェックを行うかをプログラムの実行中に動的に決定できるという点が大きな利点です。これにより、より柔軟な型チェックの実装が可能となります。

ReflectionObject::isInstance()は、そのReflectionObjectが表現するクラスに対し、引数のオブジェクトがインスタンスであるかを確認するメソッドです。これはPHPのinstanceof演算子と同様の機能ですが、ReflectionObjectを利用することで、どのクラスに対してチェックを行うかをプログラムの実行中に動的に指定できる点が利点です。通常は、より簡潔なinstanceofを使用しますが、フレームワークやライブラリ開発などで、実行時にクラス名が決定されるような高度な型チェックが必要な場合にisInstance()が役立ちます。引数には必ずオブジェクト型を渡す必要がありますのでご注意ください。