forward_static_call

(PHP 5 >= 5.3.0, PHP 7, PHP 8)

forward_static_call — 現在呼び出されたクラスを保持したままコールバックをコールする

説明

function forward_static_call(callable $callback, mixed ...$args): mixed

callback パラメータで指定したユーザー定義の関数あるいはメソッドを、それに続く引数を指定してコールします。この関数はメソッドのコンテキストでコールしなければなりません。クラスの外部で使用することはできません。コールバックがメソッドの場合は転送コールとなるため、そのメソッド内の static:: は、転送元での static:: と同じクラスに解決されます。これは、self:: や parent:: のように振る舞わせたい static メソッドをコールバックとして渡す場合に便利です。

パラメータ

callback: コールしたい関数あるいはメソッド。このパラメータは、クラス名とメソッド名を指定した配列あるいは関数名を指定した文字列となります。
args: コールバックに渡す、ゼロ個以上のパラメータ。

戻り値

関数の結果、あるいはエラー時に false を返します。

例

例1 forward_static_call() の例

<?php

class A
{
    const NAME = 'A';
    public static function test() {
        $args = func_get_args();
        echo static::NAME, " ".join(',', $args)." \n";
    }
}

class B extends A
{
    const NAME = 'B';

    public static function test() {
        echo self::NAME, "\n";
        forward_static_call(array('A', 'test'), 'more', 'args');
        forward_static_call( 'test', 'other', 'args');
    }
}

B::test('foo');

function test() {
        $args = func_get_args();
        echo "C ".join(',', $args)." \n";
    }

?>

上の例の出力は以下となります。

B
B more,args 
C other,args

参考

forward_static_call_array() - 現在呼び出されたクラスを保持したまま、パラメータの配列を指定してコールバックをコールする
call_user_func_array() - パラメータの配列を指定してコールバック関数をコールする
call_user_func() - 最初の引数で指定したコールバック関数をコールする
is_callable() - 引数が、現在のスコープから関数としてコール可能な値かどうかを調べる