(PHP 4 >= 4.0.4, PHP 5)
call_user_func_array — Вызывает пользовательскую функцию с массивом параметров
Вызывает пользовательскую функцию function, с параметрами из массива param_arr.
Вызываемая функция.
Передаваемые в функцию параметры, в качестве индексированного массива.
Возвращает результат функции или FALSE в случае ошибки.
| Версия | Описание |
|---|---|
| 5.3.0 | Изменилась интерпретация объектно-ориентированных ключевых слов, таких как parent и self. Ранее, их вызов с помощью синтаксиса двойного двоеточия вызывал предупреждение уровня E_STRICT, так как они расценивались как статические вызовы. |
Пример #1 Использование call_user_func_array()
<?php
function foobar($arg, $arg2) {
echo __FUNCTION__, " got $arg and $arg2\n";
}
class foo {
function bar($arg, $arg2) {
echo __METHOD__, " got $arg and $arg2\n";
}
}
// Вызываем функцию foobar() с 2 аргументами
call_user_func_array("foobar", array("one", "two"));
// Вызываем метод $foo->bar() с 2 аргументами
$foo = new foo;
call_user_func_array(array($foo, "bar"), array("three", "four"));
?>
Результатом выполнения данного примера будет что-то подобное:
foobar got one and two foo::bar got three and four
Пример #2 Пример использования call_user_func_array() и имени из пространства имен
<?php
namespace Foobar;
class Foo {
static public function test($name) {
print "Hello {$name}!\n";
}
}
// Начиная с версии PHP 5.3.0
call_user_func_array(__NAMESPACE__ .'\Foo::test', array('Hannes'));
// Начиная с версии PHP 5.3.0
call_user_func_array(array(__NAMESPACE__ .'\Foo', 'test'), array('Philip'));
?>
Результатом выполнения данного примера будет что-то подобное:
Hello Hannes! Hello Philip!
Пример #3 Использование lambda-функции
<?php
$func = function($arg1, $arg2) {
return $arg1 * $arg2;
};
var_dump(call_user_func_array($func, array(2, 4))); /* Начиная с версии PHP 5.3.0 */
?>
Результат выполнения данного примера:
int(8)
Замечание:
Переменные-ссылки в param_arr передаются в функцию по ссылке, вне зависимости от того, ожидает ли функция передачу соответствующего параметра по ссылке или нет. Эта форма "динамической" передачи по ссылке не выводит замечания об устаревшем поведении, но тем не менее считается устаревшей, и, скорее всего, будет удалена в следующей версии PHP. Далее, это не влияет на встроенные функции, у которых учитывается сигнатура функции. Передача по значению параметра функции, при ожидаемой передачи по ссылке, вызовет предупреждение и заставит call_user_func() вернуть FALSE (за исключением если переданное значение имеет количество ссылок (reference count) равное 1).
Замечание:
Callback-функции, зарегистрированные такими функциями как call_user_func() и call_user_func_array(), не будут вызваны при наличии непойманного исключения, брошенного в предыдущей callback-функции.