array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.call-user-func.php', 1 => 'call_user_func', 2 => 'Вызывает callback-функцию', ), 'up' => array ( 0 => 'ref.funchand.php', 1 => 'Функции управления функциями', ), 'prev' => array ( 0 => 'ref.funchand.php', 1 => 'Функции управления функциями', ), 'next' => array ( 0 => 'function.call-user-func-array.php', 1 => 'call_user_func_array', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/funchand/functions/call-user-func.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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

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