call_user_func

(PHP 4, PHP 5, PHP 7, PHP 8)

call_user_func — Вызывает callback-функцию

Описание

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

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

call_user_func_array() - Вызывает callback-функцию с массивом параметров
is_callable() - Проверяет, доступно ли значение для вызова как функция в текущей области видимости
Обращение к функциям через переменные
ReflectionFunction::invoke() - Вызывает функцию
ReflectionMethod::invoke() - Вызов

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

+Добавить

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

down

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

down

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.

down

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.

down

James at enfsolar dot com ¶

6 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

+Добавить