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
    60
    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
    18
    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
    18
    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
    7
    James at enfsolar dot com
    5 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