【PHP8.x】get_class_methods関数の使い方

<?php

/**
 * get_class_methods() 関数をデモンストレーションするためのサンプルクラスです。
 * public, protected, private, static な様々なアクセス修飾子のメソッドを含みます。
 */
class MyExampleClass
{
    // コンストラクタもメソッドとして認識されます
    public function __construct()
    {
        // 初期化処理など
    }

    /**
     * 公開メソッド
     */
    public function publicMethod(): void
    {
        // ...
    }

    /**
     * 保護メソッド
     */
    protected function protectedMethod(): void
    {
        // ...
    }

    /**
     * 非公開メソッド
     */
    private function privateMethod(): void
    {
        // ...
    }

    /**
     * 静的メソッド
     */
    public static function staticMethod(): void
    {
        // ...
    }
}

/**
 * PHP の get_class_methods() 関数の使い方を初心者向けに示します。
 * クラス名文字列とオブジェクトインスタンスのどちらを引数にしても動作することをデモンストレーションします。
 */
function demonstrateGetClassMethodsExample(): void
{
    echo "--- get_class_methods() 関数のデモンストレーション ---\n\n";

    // 1. クラス名を文字列で指定してメソッド一覧を取得
    echo "### 1. クラス名 'MyExampleClass' を直接指定した場合:\n";
    $classMethods = get_class_methods('MyExampleClass');
    echo "MyExampleClass で定義されているメソッド:\n";
    print_r($classMethods);
    echo "\n";

    // 2. クラスのオブジェクトインスタンスを作成し、それからメソッド一覧を取得
    echo "### 2. MyExampleClass のオブジェクトインスタンスを指定した場合:\n";
    $myObject = new MyExampleClass();
    $objectMethods = get_class_methods($myObject);
    echo "MyExampleClass のオブジェクトから取得したメソッド:\n";
    print_r($objectMethods);
    echo "\n";

    echo "--------------------------------------------------------\n";
    echo "補足:\n";
    echo "- `get_class_methods()` は、public, protected, private, static の\n";
    echo "  アクセス修飾子に関わらず、そのクラスで定義されている全てのメソッド名を返します。\n";
    echo "- コンストラクタ (`__construct`) のようなマジックメソッドも含まれます。\n";
}

// デモンストレーション関数を実行します。
demonstrateGetClassMethodsExample();

?>

PHPのget_class_methods関数は、指定されたクラスが持つ全てのメソッド名を文字列の配列として取得します。この関数は、引数としてクラスの「名前（文字列）」または「オブジェクトインスタンス」のどちらかを受け入れます。

例えば、MyExampleClassというクラスがある場合、get_class_methods('MyExampleClass')のようにクラス名を直接指定するか、$myObject = new MyExampleClass();のようにインスタンスを作成してからget_class_methods($myObject)としてインスタンスを渡すことができます。

戻り値は、そのクラスで定義されているメソッド名の配列です。このメソッド一覧には、public、protected、private、staticといったアクセス修飾子の区別なく、そのクラスが持つ全てのメソッドが含まれます。また、__constructのようなコンストラクタ（マジックメソッド）もリストに含まれる点が特徴です。

サンプルコードでは、MyExampleClassに定義された様々なアクセス修飾子を持つメソッドが、クラス名を文字列で指定した場合と、オブジェクトインスタンスを指定した場合の両方で、get_class_methods関数によって正しく取得されることを示しています。これにより、クラスがどのようなメソッドを持っているかを動的に調べることができます。

<?php

/**
 * このスクリプトは、PHPの get_class_methods() 関数を使用して、
 * クラスやオブジェクトが持つメソッドのリストを取得する方法を示します。
 */

// サンプル用のクラスを定義します。
class SampleClass
{
    // public メソッドは get_class_methods() で取得されます。
    public function publicMethodA()
    {
        return 'これはpublicメソッドAです。';
    }

    // public 静的メソッドも get_class_methods() で取得されます。
    public static function staticPublicMethodB()
    {
        return 'これはpublic静的メソッドBです。';
    }

    // protected メソッドはデフォルトでは get_class_methods() で取得されません。
    protected function protectedMethodC()
    {
        return 'これはprotectedメソッドCです。';
    }

    // private メソッドもデフォルトでは get_class_methods() で取得されません。
    private function privateMethodD()
    {
        return 'これはprivateメソッドDです。';
    }
}

echo "--- クラス名からメソッドを取得する場合 ---" . PHP_EOL;

// クラス名（文字列）を引数として get_class_methods() を呼び出します。
// この場合、SampleClass の public メソッドのみが配列として返されます。
$methodsFromClassName = get_class_methods('SampleClass');

echo "SampleClassのメソッドリスト (クラス名指定):" . PHP_EOL;
print_r($methodsFromClassName);
echo PHP_EOL;

echo "--- オブジェクトからメソッドを取得する場合 ---" . PHP_EOL;

// SampleClass のオブジェクトインスタンスを作成します。
$sampleObject = new SampleClass();

// オブジェクトを引数として get_class_methods() を呼び出します。
// この場合も、SampleClass の public メソッドのみが配列として返されます。
$methodsFromObject = get_class_methods($sampleObject);

echo "SampleClassのメソッドリスト (オブジェクト指定):" . PHP_EOL;
print_r($methodsFromObject);
echo PHP_EOL;

// get_class_methods() 関数は、デフォルトで public メソッドのみを返します。
// protected や private メソッドは含まれないことに注意してください。
// 静的メソッドも public であれば結果に含まれます。

?>

PHPのget_class_methods関数は、特定のクラスやオブジェクトが持つメソッドの名前をリストとして取得するために使用されます。引数には、クラスの名前を文字列で指定するか、そのクラスのオブジェクトインスタンスを直接渡すことができます。この関数は、取得されたメソッドの名前が文字列として格納された配列を返します。

サンプルコードでは、SampleClassというクラスを定義し、public、protected、private、そしてstatic publicの様々なアクセス修飾子を持つメソッドを含めました。get_class_methods関数をクラス名「SampleClass」で呼び出した場合でも、SampleClassのオブジェクトを引数として渡した場合でも、結果は同じになります。どちらの場合も、publicMethodAとstaticPublicMethodBというpublicなメソッドのみが配列として返されます。重要な点として、protectedMethodCやprivateMethodDのようにpublicではないメソッドは、デフォルトでは結果に含まれません。この関数は、プログラム実行時に動的にクラスのメソッド構成を調べたい場合などに役立ちます。

<?php

// 親クラスを定義します
class ParentClass
{
    public function parentMethod1(): string
    {
        return "Parent method 1";
    }

    protected function parentMethod2(): string
    {
        return "Parent method 2";
    }

    // private メソッドは get_class_methods の通常の呼び出しではリストされません。
    private function parentMethod3(): string
    {
        return "Parent method 3";
    }
}

// 子クラスを定義します。ParentClassを継承します。
class ChildClass extends ParentClass
{
    public function childMethodA(): string
    {
        return "Child method A";
    }

    public function childMethodB(): string
    {
        return "Child method B";
    }

    // 親クラスのメソッドをオーバーライドします。
    // get_class_methods はメソッド名をリストしますが、
    // array_diff を使用して親メソッドを除外する場合、同名のメソッドは除外される点に注意してください。
    public function parentMethod1(): string
    {
        return "Child overridden parent method 1";
    }
}

/**
 * 指定されたクラスに直接定義されているメソッドのみを取得する関数。
 * 親クラスから継承されたメソッドは除外します。
 *
 * 注意: この関数は get_class_methods の結果 (メソッド名のみの配列) を使用するため、
 * 親クラスと子クラスで同名のメソッド (オーバーライドされたメソッド) は、
 * array_diff の比較により除外されます。
 * つまり、子クラスで新たに定義されたメソッドのみを抽出したい場合に適しています。
 * オーバーライドされたメソッドも「自身のメソッド」として含めたい場合は、
 * Reflection API を使用する必要があります。
 *
 * @param string $className メソッドを取得するクラスの名前 (例: MyClass::class)
 * @return array クラスに直接定義されているメソッド名の配列 (オーバーライドされた同名メソッドは除外される可能性があります)
 */
function getOwnMethods(string $className): array
{
    // 指定されたクラスのすべてのメソッド名を取得します (継承されたメソッドを含む)
    // get_class_methods は通常、public および protected メソッドを返します。
    $allMethods = get_class_methods($className);

    // 親クラスの名前を取得します
    $parentClass = get_parent_class($className);

    if ($parentClass) {
        // 親クラスのすべてのメソッド名を取得します
        $parentMethods = get_class_methods($parentClass);
        // 子クラスのメソッド名リストから、親クラスに存在するメソッド名を除外します。
        // ここで、子クラスでオーバーライドされた同名のメソッドも除外されます。
        $ownMethods = array_diff($allMethods, $parentMethods);
    } else {
        // 親クラスがない場合、すべてのメソッドがそのクラス自身のメソッドです
        $ownMethods = $allMethods;
    }

    // array_diff はキーを保持するため、キーをリセットして返します
    return array_values($ownMethods);
}

// --- 使用例 ---

echo "=== ChildClassのすべてのメソッド (継承されたもの、オーバーライドされたものを含む) ===\n";
// get_class_methodsは、自身と親クラスのpublic/protectedメソッドをすべて返します
print_r(get_class_methods(ChildClass::class));
echo "\n";

echo "=== ParentClassのすべてのメソッド ===\n";
print_r(get_class_methods(ParentClass::class));
echo "\n";

echo "=== ChildClassに直接定義されているメソッドのみ (getOwnMethods関数を使用) ===\n";
// getOwnMethods関数を使用して、ChildClassに直接定義されているメソッドのみを取得します。
// オーバーライドされた parentMethod1 は除外されます。
print_r(getOwnMethods(ChildClass::class));
echo "\n";

echo "=== 参考: ParentClassに直接定義されているメソッドのみ ===\n";
// ParentClassには親がないため、get_class_methodsと同じ結果になります
print_r(getOwnMethods(ParentClass::class));
echo "\n";

?>

PHPのget_class_methods関数は、指定されたクラスまたはオブジェクトが持つメソッドの名前を文字列の配列として取得する際に使用します。引数にはクラス名を文字列で渡すか、オブジェクトを直接指定します。戻り値は、そのクラスがアクセス可能なpublicおよびprotectedなメソッド名の配列です。この関数は、自身のクラスに定義されたメソッドだけでなく、親クラスから継承されたメソッドもすべて含めてリストします。

もし、親クラスから継承されたメソッドを除外し、そのクラス自身に直接定義されているメソッドのみを取得したい場合は、追加の処理が必要です。サンプルコードのgetOwnMethods関数はこのニーズに応えるものです。この関数では、まずget_class_methodsで対象クラスの全メソッドを取得します。次に、get_parent_class関数で親クラス名を取得し、親クラスのメソッドも同様にget_class_methodsで取得します。最後に、array_diff関数を用いて対象クラスのメソッドリストから親クラスのメソッドリストを除外することで、自身に定義されたメソッドのみを抽出します。ただし、この方法では、子クラスで親クラスのメソッドをオーバーライドしている場合、同名のメソッドとして扱われるため、そのオーバーライドされたメソッドも除外されてしまう点に留意してください。

<?php

/**
 * サンプルクラス
 * get_class_methods の動作を確認するために使用します。
 */
class MySampleClass
{
    public function publicMethod(): void
    {
        // 公開メソッド
    }

    protected function protectedMethod(): void
    {
        // 保護メソッド
    }

    private function privateMethod(): void
    {
        // プライベートメソッド
    }

    public static function staticMethod(): void
    {
        // 静的メソッド
    }
}

// クラス名を文字列で指定してメソッド一覧を取得
echo "--- クラス名 'MySampleClass' を指定した場合 ---" . PHP_EOL;
$methods_from_string = get_class_methods('MySampleClass');
if ($methods_from_string !== false) {
    foreach ($methods_from_string as $method) {
        echo "- " . $method . PHP_EOL;
    }
} else {
    echo "メソッドの取得に失敗しました。" . PHP_EOL;
}

echo PHP_EOL;

// オブジェクトインスタンスを渡してメソッド一覧を取得
echo "--- MySampleClass のオブジェクトインスタンスを渡した場合 ---" . PHP_EOL;
$object_instance = new MySampleClass();
$methods_from_object = get_class_methods($object_instance);
if ($methods_from_object !== false) {
    foreach ($methods_from_object as $method) {
        echo "- " . $method . PHP_EOL;
    }
} else {
    echo "メソッドの取得に失敗しました。" . PHP_EOL;
}

?>

PHPのget_class_methods関数は、指定されたクラスに定義されているすべてのメソッドの名前を配列として取得します。この関数は、プログラム実行中にクラスの構造（リフレクション）を動的に調べたい場合に非常に便利です。

引数には、メソッド一覧を取得したいクラスの「クラス名を文字列」として渡すか、そのクラスの「オブジェクトインスタンス」を渡すことができます。どちらの方法でも、そのクラスが持つメソッドのリストを取得可能です。

戻り値は、クラスに定義されているメソッド名が格納された文字列の配列です。もし指定されたクラスが存在しないなど、メソッドの取得に失敗した場合はfalseが返されます。

サンプルコードでは、MySampleClassというクラスに定義された公開（public）、保護（protected）、プライベート（private）、静的（static）の各メソッドを例に、クラス名を直接文字列で指定する方法と、クラスのオブジェクトインスタンスを渡す方法の二通りでメソッド一覧を取得し、その結果を表示しています。これにより、アクセス修飾子に関わらず、すべてのメソッド名が取得されることを確認できます。