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

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

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

基本的な使い方

getModifierNamesメソッドは、PHPのリフレクション機能において、クラス、メソッド、またはプロパティに適用されている修飾子を、人間が読める文字列の形式で取得するメソッドです。

このメソッドは、指定された整数値の引数を受け取ります。この整数値は、ReflectionMethod::getModifiers()やReflectionProperty::getModifiers()といったリフレクション関連の他のメソッドから取得できる、修飾子の集合を表すビットマスク形式の数値です。例えば、publicやstaticといった修飾子は、内部的には特定の数値で表現されていますが、このメソッドを使用することで、その数値表現を「public」や「static」のような具体的な文字列に変換できます。

戻り値としては、対応する修飾子名の文字列が格納された配列を返します。例えば、public staticという修飾子を持つ要素の数値を与えた場合、['public', 'static']のような配列が返されます。

主に、実行時にコードの構造を動的に解析し、特定のクラスメンバーがどのようなアクセスレベルや特性を持っているかを確認したい場合に利用されます。これにより、デバッグツールやコードジェネレーター、フレームワークの内部処理などで、オブジェクトのメタ情報を柔軟に扱うことが可能となります。PHPのプログラムが自身の構造を深く理解し、それに基づいて振る舞いを調整する際に非常に役立つ機能です。

構文(syntax)


1<?php
2
3$modifierBits = ReflectionMethod::IS_PUBLIC | ReflectionMethod::IS_STATIC;
4$modifierNames = Reflection::getModifierNames($modifierBits);
5print_r($modifierNames);
6
7?>

引数(parameters)

int $modifiers

int $modifiers: 取得したい修飾子を表す整数

戻り値(return)

array

Reflection::getModifierNames メソッドは、指定されたリフレクションオブジェクトが持つ修飾子（public, private, static など）を文字列の配列として返します。