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

<?php

declare(strict_types=1);

/**
 * 親クラス
 */
class ParentClass
{
    /**
     * メッセージと呼び出し元のクラスコンテキストを表示します。
     * `static::who()` は遅延静的束縛により、実行時のクラスの `who()` を呼び出します。
     *
     * @param string $message 表示するメッセージ
     */
    public static function test(string $message): void
    {
        echo "Message: {$message}" . PHP_EOL;
        echo 'Context: ';
        static::who();
    }

    /**
     * 呼び出されたクラスの名前を表示します。
     */
    public static function who(): void
    {
        echo __CLASS__ . PHP_EOL;
    }
}

/**
 * 子クラス
 */
class ChildClass extends ParentClass
{
    /**
     * 親クラスの `who()` メソッドをオーバーライドします。
     */
    public static function who(): void
    {
        echo __CLASS__ . PHP_EOL;
    }

    /**
     * `forward_static_call_array` を使って親のメソッド呼び出しを転送します。
     * この関数は、呼び出し元のクラス(この場合は ChildClass)のコンテキストを
     * 保持したまま、指定された静的メソッドを呼び出します。
     *
     * @param string $message 親メソッドに渡すメッセージ
     */
    public static function forwardTheCall(string $message): void
    {
        // `ParentClass::test` メソッドを、引数を配列で渡して呼び出します。
        // この時、呼び出し元である `ChildClass` のコンテキストが転送されるため、
        // `ParentClass::test` 内の `static::who()` は `ChildClass::who()` を実行します。
        forward_static_call_array([ParentClass::class, 'test'], [$message]);
    }
}

// 子クラスのメソッドを呼び出します。
ChildClass::forwardTheCall('Hello from ChildClass!');

/*
--- 期待される出力 ---
Message: Hello from ChildClass!
Context: ChildClass
*/

このサンプルコードは、forward_static_call_array 関数を使い、呼び出し元のクラスの情報を維持したまま別の静的メソッドを呼び出す例です。この関数は、第一引数に callable 型で指定された静的メソッドなどを、第二引数に指定された配列の要素を引数として渡して実行します。

この関数の最大の特徴は、呼び出し元の「静的コンテキスト」を転送する点にあります。サンプルでは ChildClass のメソッド内から ParentClass::test を呼び出しています。この時、forward_static_call_array は ChildClass のコンテキストを ParentClass::test メソッドに引き継ぎます。

ParentClass::test の内部では static::who() が呼び出されます。これは「遅延静的束縛」という仕組みで、実行時のクラスで定義されたメソッドを呼び出します。今回は ChildClass のコンテキストが引き継がれているため、ChildClass でオーバーライドされた who メソッドが実行されます。その結果、出力は ParentClass ではなく ChildClass と表示されます。

このように、継承関係において、子クラスの振る舞いを保ちつつ親クラスのメソッドを再利用したい場合などに有効です。関数の戻り値は、第一引数で呼び出されたメソッドの戻り値そのものとなります。