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

getReflectionConstantメソッドは、ReflectionObjectクラスに属し、実行中のオブジェクトに定義されているクラス定数に関する情報を取得するメソッドです。

ReflectionObjectクラスは、PHPのリフレクションAPIの一部として、プログラムの実行中に特定のオブジェクトの構造やメンバ（プロパティ、メソッド、定数など）について、詳細な情報を動的に取得することを可能にします。

このgetReflectionConstantメソッドは、特定のオブジェクトが持つクラス定数の情報を、ReflectionClassConstantという特別なオブジェクトとして返します。このメソッドを使用するには、引数として情報を取得したいクラス定数の名前を文字列で指定します。例えば、あるオブジェクトに定義されているMAX_LIMITのような定数について、その値や可視性といった詳細な情報を知りたい場合に役立ちます。

戻り値として得られるReflectionClassConstantオブジェクトからは、定数の名前、具体的な値、そしてその定数の公開範囲（public, protected, privateなど）といった様々なメタデータを取得できます。これにより、開発者はプログラムの実行時にオブジェクトの定数を動的に解析し、特定の条件に基づいて処理を分岐させるなど、より柔軟なプログラム制御を行うことが可能になります。このメソッドはPHP 8以降で導入され、リフレクション機能をより細かく活用するための強力な手段を提供します。

Copy
1<?php
2
3class MyClass
4{
5    const MY_CONSTANT = 'example_value';
6}
7
8$object = new MyClass();
9$reflector = new ReflectionObject($object);
10
11$reflectionConstant = $reflector->getReflectionConstant('MY_CONSTANT');
12
13if ($reflectionConstant) {
14    echo $reflectionConstant->getName() . ': ' . $reflectionConstant->getValue();
15}
16

string $name

• string $name: 定数名を指定する文字列

ReflectionClassConstant|null

指定された名前のクラス定数に対応する ReflectionClassConstant オブジェクトを返します。指定された定数が存在しない場合は、null を返します。