call_user_func

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

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

Описание

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-функция.

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