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

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

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

基本的な使い方

getConstantsメソッドは、指定されたオブジェクトに定義されているすべての定数を取得するメソッドです。

このメソッドは、PHPのリフレクションAPIの一部であるReflectionObjectクラスに属しています。リフレクションAPIは、プログラムの実行中にクラス、オブジェクト、メソッド、プロパティなどの情報を動的に調べることができる強力な機能を提供します。

getConstantsメソッドを呼び出すことで、対象のオブジェクトが自身で定義している定数や、親クラスから継承した定数を含め、そのオブジェクトが利用できるすべての定数に関する情報を取得できます。戻り値は連想配列形式で、配列のキーが定数名、値がその定数の値となります。

例えば、あるオブジェクトが持つ特定の設定定数を実行時に確認したい場合や、デバッグ中にオブジェクトの内部状態を詳細に分析したい場合に非常に役立ちます。また、フレームワークやライブラリ開発において、オブジェクトの動的な振る舞いを解析したり、拡張機能を構築したりする際にも活用されます。システムエンジニアを目指す方にとって、プログラムの構造を深く理解し、柔軟な処理を実装するための重要なツールの一つと言えるでしょう。

構文(syntax)


1<?php
2
3class MyConstants
4{
5    public const APP_NAME = 'MyApp';
6    protected const VERSION = '1.0.0';
7    private const SECRET_KEY = 'super_secret';
8}
9
10$object = new MyConstants();
11$reflector = new ReflectionObject($object);
12
13// オブジェクトに定義されている全ての定数を取得する
14$constants = $reflector->getConstants();
15
16print_r($constants);
17
18?>

引数(parameters)

int $filter = 0

int $filter = 0: 取得する定数をフィルタリングするための整数。デフォルトは0で、すべての定数を取得します。

戻り値(return)

array

ReflectionObject::getConstants は、対象となるオブジェクトのクラスで定義されているすべての定数を、名前をキー、値をバリューとする連想配列として返します。