call_user_func

(PHP 4, PHP 5, PHP 7)

call_user_funcВызывает callback-функцию, заданную в первом параметре

Описание

call_user_func ( callable $callback [, mixed $... ] ) : mixed

Вызывает callback-функцию, переданную первым параметром, и передает остальные параметры в качестве аргументов. callback.

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

callback

Вызываемая функция типа callable.

...

Ноль или более параметров, передаваемые в 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";
?>

Результат выполнения данного примера:

Warning: Parameter 1 to increment() expected to be a reference, value given in …
0
1

Возвращаемые значения

Возвращает значение, возвращенное callback-функцией.

Список изменений

Версия Описание
5.3.0 Изменилась интерпретация объектно-ориентированных ключевых слов, таких как parent и self. Ранее, при их вызове с помощью синтаксиса двойного двоеточия вызывалась ошибка уровня E_STRICT, т.к. они интерпретировались как статические вызовы.
5.3.0 Если вызываемая функция ожидает передачи параметра по ссылке, будет выдана ошибка уровня E_WARNING.

Примеры

Пример #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-функции.

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