call_user_func

(PHP 4, PHP 5, PHP 7, PHP 8)

call_user_func — Вызывает callback-функцию

Описание

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

Функция вызывает callback-функцию, которую определили в первом параметре, а значения остальных параметров передаёт в функцию обратного вызова как аргументы.

Список параметров

callback

Значение с типом callable, которое требуется вызвать как функцию.

args

Ноль или больше аргументов для передачи в callback-функцию.

Замечание:

Учтите, что аргументы для функции call_user_func() не передаются по ссылке.

Пример #1 Пример вызова функции call_user_func() и передача аргумента по ссылке

<?php

error_reporting(E_ALL);

function increment(&$var)
{
    $var++;
}

$a = 0;
call_user_func('increment', $a);
echo $a."\n";

// Вместо вызова функции call_user_func() возможно вызывать функцию call_user_func_array()
call_user_func_array('increment', array(&$a));
echo $a."\n";

// Возможно также вызывать функцию переменной
$increment = 'increment';
$increment($a);

echo $a . "\n";

?>

Результат выполнения приведённого примера: 

Warning: Parameter 1 to increment() expected to be a reference, value given in …
0
1
2

Возвращаемые значения

Функция возвращает значение, которое вернула callback-функция.

Примеры

Пример #2 Пример вызова callback-функции функцией call_user_func()

<?php

function barber($type)
{
    echo "Вы хотели стрижку $type, без проблем\n";
}

call_user_func('barber', "под горшок");
call_user_func('barber', "наголо");

?>

Результат выполнения приведённого примера: 

Вы хотели стрижку под горшок, без проблем
Вы хотели стрижку наголо, без проблем

Пример #3 Пример вызова функции call_user_func() в пространстве имён

<?php

namespace Foobar;

class Foo
{
    static public function test()
    {
        print "Привет, мир!\n";
    }
}

call_user_func(__NAMESPACE__ . '\Foo::test');
call_user_func(array(__NAMESPACE__ . '\Foo', 'test'));

?>

Результат выполнения приведённого примера: 

Привет, мир!
Привет, мир!

Пример #4 Пример вызова метода класса через функцию call_user_func()

<?php

class MyClass
{
    static function say_hello()
    {
        echo "Привет!\n";
    }
}

$classname = "MyClass";

call_user_func(array($classname, 'say_hello'));
call_user_func($classname . '::say_hello');

$myobject = new MyClass();

call_user_func(array($myobject, 'say_hello'));

?>

Результат выполнения приведённого примера: 

Привет!
Привет!
Привет!

Пример #5 Пример вызова лямбда-функции через функцию call_user_func()

<?php

call_user_func(function ($arg) {
    print "[$arg]\n";
}, 'test');

?>

Результат выполнения приведённого примера: 

[test]

Примечания

Замечание: Callback-функции, которые зарегистрировали функцией call_user_func() или call_user_func_array(), не вызовутся при непойманном исключении, которое выбросила предыдущая callback-функция.

Смотрите также