call_user_func
(PHP 4, PHP 5, PHP 7)
call_user_func — Вызывает пользовательскую функцию, указанную в первом параметре
Описание
Вызывает пользовательскую функцию, переданную в параметре
callback.
Список параметров
-
callback -
Вызываемая функция типа callable.
-
parameter -
Ноль или более параметров, передаваемые в функцию.
Замечание:
Учтите, что параметры для 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_array('increment', array(&$a));
echo $a."\n";
?>Результат выполнения данного примера:
0 1
Возвращаемые значения
Возвращает результат функции, или FALSE в случае ошибки.
Список изменений
| Версия | Описание |
|---|---|
| 5.3.0 |
Изменилась интерпретация объектно-ориентированных ключевых слов, таких
как parent и self.
Ранее, при их вызове с помощью синтаксиса двойного двоеточия
вызывалась ошибка уровня E_STRICT, т.к.
они интерпретировались как статические вызовы.
|
Примеры
Пример #2 Пример использования 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'); // Начиная с версии PHP 5.3.0
call_user_func(array(__NAMESPACE__ .'\Foo', 'test')); // Начиная с версии PHP 5.3.0
?>
Результат выполнения данного примера:
Привет, мир! Привет, мир!
Пример #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'); // Начиная с версии 5.2.3
$myobject = new myclass();
call_user_func(array($myobject, 'say_hello'));
?>
Результат выполнения данного примера:
Привет! Привет! Привет!
Пример #5 Использование лямбда-функции и call_user_func()
<?php
call_user_func(function($arg) { print "[$arg]\n"; }, 'test'); /* Начиная с версии PHP 5.3.0 */
?>
Результат выполнения данного примера:
[test]
Примечания
Замечание:
Callback-функции, зарегистрированные такими функциями как call_user_func() и call_user_func_array(), не будут вызваны при наличии не пойманного исключения, брошенного в предыдущей callback-функции.
Смотрите также
- call_user_func_array() - Вызывает пользовательскую функцию с массивом параметров
- is_callable() - Проверяет, может ли значение переменной быть вызвано в качестве функции
- информация о типе callback
- ReflectionFunction::invoke() - Вызывает функцию
- ReflectionMethod::invoke() - Вызов
Коментарии
You don't need to use this function to call a variable class function. Instead you can do the following:
$this->{$fnname}();
The example works in PHP 5 from within the class. It is the {} that do the trick.
Regards,
Julian.
A good use for call_user_func(); is for recursive functions.
If you're distributing code, you will often come across users who will rename functions and break the code..
Use this: call_user_func(__FUNCTION__, ... ); inside a function to call itself with whatever parameters you want.
<?php
// example, an extremely simplified factorial calculator..
// it's quite obvious when someone renames the function, it'll spit out an error because it wants to call itself.
function Factorial($i=1) {
return($i==1?1:$i*Factorial($i-1));
}
// you can give this function whatever name you want, it'll always work, of course if you initially call it using the name you gave it.
function qwertyuiop($i=1) {
return($i==1?1:$i*call_user_func(__FUNCTION__,$i-1));
}
?>
Just that I didn't see any reference to recursive functions when user_call_func(); really helps.
if you simply want to dynamically call a method on an object it is not necessary to use call_user_function but instead you can do the following:
<?php
$method_name = "AMethodName";
$obj = new ClassName();
$obj->{$method_name}();
?>
I've used the above so I know it works.
Regards,
-- Greg
<?php
class MyClass{
public function hello($str)
{
echo 'hello ' . $str;
}
}
$obj = new MyClass();
[$obj, 'hello']('World'); // the array can be called as a function