php8.5
Home/ Manual/ funchand / functions/ forward_static_call

forward_static_call

PHP function Edit on GitHub ✎

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

Call a callback while preserving the current called class

Description

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

Calls a user defined function or method given by the callback parameter, with the following arguments. This function must be called within a method context, it can't be used outside a class. When calling a method callback, it makes a forwarding call, so static:: inside the method resolves to the same called class as in the caller. This is useful for static method callbacks that should behave like self:: or parent::.

Parameters

callback

The function or method to be called. This parameter may be an array, with the name of the class, and the method, or a string, with a function name.

args

Zero or more parameters to be passed to the callback.

Return Values

Returns the function result, or false on error.

Examples

forward_static_call() example

php
<?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";
    }

?>

The above example will output:

output
B
B more,args 
C other,args

See Also

Source: reference/funchand/functions/forward-static-call.xml · from the official PHP manual (php/doc-en)