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

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

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

基本的な使い方

getReflectionConstantsメソッドは、PHP 8.1以降で利用可能なReflectionEnumクラスに属し、列挙型（Enum）に定義されているすべてのケースに関するリフレクション情報を取得するメソッドです。

このメソッドは、指定された列挙型に存在するすべてのケース、すなわちEnumメンバーをReflectionEnumUnitCaseまたはReflectionEnumBackedCaseオブジェクトの配列として返します。ReflectionEnumUnitCaseは関連する値を持たない純粋な列挙ケースを表し、ReflectionEnumBackedCaseは整数や文字列などのバックアップ値を持つケースを表します。

システムエンジニアを目指す初心者の方にとって、リフレクションとは、プログラムの実行中に自身の構造や振る舞いを調べたり変更したりする機能と理解してください。このgetReflectionConstantsメソッドは、実行時に列挙型が持つ定数を動的に調べたい場合に非常に役立ちます。例えば、利用可能なすべての列挙ケースをリストアップしたり、それぞれのケースがバックアップ値を持つかどうかを判断したりする際に使用します。

このメソッドを利用することで、列挙型の定義を直接参照することなく、その内部構造をプログラム的に把握し、より柔軟で汎用的なコードを記述することが可能になります。これにより、Enumを利用したアプリケーションの動的な処理や、ツール作成の際にコードの可読性と保守性を高めることができます。

構文(syntax)


1<?php
2
3enum Status
4{
5    case PENDING;
6    case APPROVED;
7    case REJECTED;
8}
9
10$reflectionEnum = new ReflectionEnum(Status::class);
11
12$reflectionConstants = $reflectionEnum->getReflectionConstants();
13
14?>

引数(parameters)

?int $filter = NULL

?int $filter = NULL: 取得する定数をフィルタリングするための整数。指定しない場合はすべての定数が取得されます。

戻り値(return)

ReflectionEnumUnitCase[]|ReflectionEnumBackedCase[]

このメソッドは、対象のEnum（列挙型）に含まれるすべてのケースを、それぞれの型（純粋なEnumケースか、値を持つBacked Enumケースか）に応じて ReflectionEnumUnitCase または ReflectionEnumBackedCase の配列として返します。