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

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

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

基本的な使い方

isSubclassOfメソッドは、ReflectionClassクラスに属し、指定されたクラスが別のクラスのサブクラスであるかどうかを判定するメソッドです。

ReflectionClassは、PHPプログラムの実行中にクラスに関する詳細な情報を取得するための強力な機能（リフレクションAPI）を提供します。このisSubclassOfメソッドは、ReflectionClassオブジェクトが表すクラスが、引数として渡されたクラス（またはクラス名）の直接的、あるいは間接的な子孫クラスであるかを調べます。

具体的には、あるクラスが別のクラスから特性や振る舞いを受け継いでいる関係（継承関係）にあるかを動的に確認したい場合に利用されます。メソッドは真偽値（trueまたはfalse）を返します。trueが返された場合、ReflectionClassオブジェクトが示すクラスは、引数で指定されたクラスのサブクラスであることがわかります。反対にfalseが返された場合は、サブクラスではありません。

この機能は、例えば、特定の基底クラス（親クラス）を継承しているクラスだけを処理の対象としたい場合や、フレームワーク内で動的にロードされるクラスの型を検証したい場合などに非常に有用です。実行時にクラスの継承関係をプログラム的にチェックすることで、より柔軟で堅牢なアプリケーションの設計が可能になります。PHP 8環境において、リフレクションAPIを用いた高度な型チェックやクラスの動的な分析をサポートする重要なメソッドの一つです。

構文(syntax)


1<?php
2$reflectionClass = new ReflectionClass('ClassName');
3$isSubclass = $reflectionClass->isSubclassOf('ParentClassName');

引数(parameters)

ReflectionClass|string $class

ReflectionClass|string $class: サブクラスかどうかを判定したいクラスのReflectionClassオブジェクト、またはクラス名を表す文字列

戻り値(return)

bool

このメソッドは、指定されたクラスが現在のクラスのサブクラスである場合に true を、そうでない場合に false を返します。