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

<?php

/**
 * Base class to demonstrate get_called_class().
 */
class BaseClass
{
    /**
     * A static method that returns the name of the class from which it was called.
     * This uses late static binding.
     *
     * @return string The name of the class that invoked this method.
     */
    public static function getClassUsedForCall(): string
    {
        // get_called_class() returns the name of the class this static method was called on.
        return get_called_class();
    }
}

/**
 * A derived class that extends BaseClass.
 */
class DerivedClass extends BaseClass
{
    // No additional methods needed for this demonstration.
}

// Demonstrate calling the static method directly from the base class.
echo "Called from BaseClass directly: " . BaseClass::getClassUsedForCall() . PHP_EOL;

// Demonstrate calling the static method from the derived class.
echo "Called from DerivedClass: " . DerivedClass::getClassUsedForCall() . PHP_EOL;

// It can also be called from an object instance, though it's a static method.
$obj = new DerivedClass();
echo "Called from DerivedClass instance: " . $obj::getClassUsedForCall() . PHP_EOL;

?>

PHPのget_called_class関数は、静的メソッドがどのクラスから呼び出されたかを特定するために使用されます。この関数は引数を持ちませんが、呼び出し元のクラス名を文字列として返します。

提供されたサンプルコードでは、BaseClassに定義された静的メソッドgetClassUsedForCallの中でget_called_classが利用されています。このメソッドをBaseClass::getClassUsedForCall()のように直接呼び出すと、get_called_classはBaseClassという文字列を返します。一方、DerivedClassがBaseClassを継承しており、DerivedClass::getClassUsedForCall()のように呼び出すと、get_called_classはDerivedClassという文字列を返します。

これはPHPの「遅延静的束縛（Late Static Binding）」という機能によるもので、メソッドが実際に実行された時点での呼び出し元クラスを正確に取得できるためです。静的メソッドは通常クラス名で呼び出しますが、オブジェクトのインスタンスから呼び出しても、そのインスタンスのクラス名が正しく取得されます。この機能は、共通処理を持つ継承クラス群において、呼び出し元クラスに応じて異なる振る舞いをさせたい場合などに非常に有用です。

<?php

/**
 * プログラミング言語: PHP
 * 関数名: get_called_class
 * 説明: このサンプルコードは、get_called_class() 関数がどのように機能するかを示します。
 *       この関数は、静的メソッドが呼び出された際の「呼び出し元」のクラス名を取得するために使用されます。
 *       名前空間を使用しないシンプルなケースで、その動作を理解するのに役立ちます。
 */

/**
 * 親クラスを定義します。
 * このクラスは、get_called_class() を使用する静的メソッドを持っています。
 */
class Animal
{
    /**
     * この静的メソッドは、現在静的呼び出しが行われているクラスの名前を返します。
     *
     * @return string 呼び出し元のクラスの名前
     */
    public static function whoAmI()
    {
        // get_called_class() は、静的メソッドを「呼び出した」クラスの名前を返します。
        // これは、メソッドが「定義されている」クラス名 (__CLASS__ など) とは異なる場合があります。
        return get_called_class();
    }
}

/**
 * Animal クラスを継承する子クラスを定義します。
 * このクラスは Animal の whoAmI() メソッドを継承します。
 */
class Dog extends Animal
{
    // Dog クラスは whoAmI() メソッドを直接定義していませんが、親クラスから継承しています。
}

/**
 * Animal クラスを継承する別の子クラスを定義します。
 */
class Cat extends Animal
{
    // Cat クラスも whoAmI() メソッドを継承しています。
}

// --- get_called_class() の動作確認 ---

// Animal クラスから直接静的メソッドを呼び出す場合
// この場合、呼び出し元もメソッドの定義元も Animal なので "Animal" が返されます。
echo "Animal::whoAmI() の結果: " . Animal::whoAmI() . PHP_EOL;

// Dog クラスから静的メソッドを呼び出す場合
// whoAmI() メソッド自体は Animal クラスで定義されていますが、
// 実際に呼び出しを行ったのは Dog クラスなので "Dog" が返されます。
echo "Dog::whoAmI() の結果: " . Dog::whoAmI() . PHP_EOL;

// Cat クラスから静的メソッドを呼び出す場合
// 同様に、呼び出しを行ったのは Cat クラスなので "Cat" が返されます。
echo "Cat::whoAmI() の結果: " . Cat::whoAmI() . PHP_EOL;

// 実行結果は、get_called_class() がメソッドの「定義元」ではなく、
// メソッドの「呼び出し元」のクラス名を正確に返すことを示しています。
// このサンプルは、名前空間を使用しないシンプルな状況での動作を示しています。

PHPのget_called_class()関数は、静的メソッドが呼び出された際に、実際にそのメソッドを「呼び出した」クラスの名前（文字列）を取得するために使用されます。この関数は引数を一切取らず、常に呼び出し元のクラス名を文字列として返します。

通常のクラスメソッド内では、__CLASS__マジック定数を使うとメソッドが「定義されている」クラス名を取得できますが、get_called_class()はメソッドが継承され、子クラスから静的に呼び出された場合など、「実際に呼び出しが行われた」クラスの名前を正確に特定する点で異なります。

提供されたサンプルコードでは、Animalクラスに静的メソッドwhoAmI()が定義されており、この中でget_called_class()が使われています。DogクラスとCatクラスはAnimalクラスを継承しています。

Animal::whoAmI()を呼び出すと、メソッドの定義元も呼び出し元もAnimalなので「Animal」と返されます。しかし、Dog::whoAmI()を呼び出すと、whoAmI()メソッド自体はAnimalに定義されていますが、実際に呼び出したのはDogクラスであるため「Dog」と返されます。同様に、Cat::whoAmI()は「Cat」を返します。

このように、get_called_class()は、継承関係にあるクラスから静的メソッドを呼び出す際に、現在どのクラスのコンテキストで実行されているかを判断するのに非常に役立ちます。このサンプルは、名前空間を使用しないシンプルなケースで、その基本的な動作を明確に示しています。

<?php

class BaseClass {
    public static function whoCalled() {
        // 呼び出し元のクラス名を取得
        $className = get_called_class();
        echo "呼び出したクラス: " . $className . PHP_EOL;
    }
}

class SubClass extends BaseClass {
    public static function test() {
        parent::whoCalled();
    }
}

// BaseClass から呼び出す
BaseClass::whoCalled();

// SubClass から呼び出す
SubClass::test();

?>

このPHPサンプルコードは、get_called_class()関数を使用して、静的メソッドを呼び出したクラス名を取得する方法を示しています。get_called_class()関数は引数を取らず、呼び出したクラスの名前を文字列として返します。この関数は、静的メソッドまたは遅延静的束縛（late static binding）で使用される場合に特に役立ちます。

BaseClassという基底クラスには、whoCalled()という静的メソッドが定義されています。このメソッド内でget_called_class()関数を呼び出すことで、そのメソッドを呼び出したクラスの名前を取得し、出力しています。SubClassはBaseClassを継承しており、test()メソッド内でparent::whoCalled()を呼び出すことで、基底クラスのwhoCalled()メソッドを呼び出しています。

サンプルコードを実行すると、まずBaseClass::whoCalled()が直接呼び出されるため、「呼び出したクラス: BaseClass」と出力されます。次に、SubClass::test()が呼び出され、その中でparent::whoCalled()が呼び出されるため、「呼び出したクラス: SubClass」と出力されます。

このように、get_called_class()関数は、継承関係にあるクラス間で、どのクラスからメソッドが呼び出されたかを特定する際に役立ちます。特に、親クラスで定義されたメソッドが、子クラスによってオーバーライドされる場合に、その振る舞いを制御するために利用できます。