PHP 8.4.0 RC4 available for testing

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.

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

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_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 Пример использования 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-функция.

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

Добавить

Примечания пользователей 4 notes

up
55
gskluzacek dot nospam at gmail dot com
14 years ago
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
up
19
Knightnet
17 years ago
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.
up
19
Nitrogen
15 years ago
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.
up
6
James at enfsolar dot com
4 years ago
<?php

class MyClass{

public function
hello($str)

{

echo
'hello ' . $str;

}

}

$obj = new MyClass();

[
$obj, 'hello']('World'); // the array can be called as a function
To Top