PHP Conference Fukuoka 2025

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

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

Добавить

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

up
55
gskluzacek dot nospam at gmail dot com
15 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
18 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
16 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
5 years ago
<?phpclass MyClass{    public function hello($str)    {        echo 'hello ' . $str;    }}$obj = new MyClass();[$obj, 'hello']('World'); // the array can be called as a function
To Top