Edit Report a Bug

    ReflectionFunction::invokeArgs

    (PHP 5 >= 5.1.2, PHP 7, PHP 8)

    ReflectionFunction::invokeArgs — Вызов функции с передачей аргументов

    Описание

    public ReflectionFunction::invokeArgs(array $args): mixed

    Вызывает функцию и передаёт ей аргументы в виде массива.

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

    args

    Передаваемые функции аргументы в виде массива. Поведение функции аналогично call_user_func_array().

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

    Возвращает результат выполнения вызванной функции.

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

    Версия Описание
    8.0.0 Ключи args теперь интерпретируются как имена параметров, а не игнорируются.

    Примеры

    Пример #1 Пример использования ReflectionFunction::invokeArgs()

    <?php
    function title($title, $name)
    {
    return     sprintf("%s. %s\r\n", $title, $name);
    }

    $function = new ReflectionFunction('title');

    echo     $function->invokeArgs(array('Dr', 'Phil'));
    ?>

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

    Dr. Phil

    Пример #2 Пример использования ReflectionFunction::invokeArgs() со ссылками на аргументы

    <?php
    function get_false_conditions(array $conditions, array &$false_conditions)
    {
    foreach (    $conditions as $condition) {
    if (!    $condition) {
    $false_conditions[] = $condition;
    }
    }
    }

    $function_ref = new ReflectionFunction('get_false_conditions');

    $conditions = array(true, false, -1, 0, 1);
    $false_conditions = array();

    $function_ref->invokeArgs(array($conditions, &$false_conditions));

    var_dump($false_conditions);
    ?>

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

    array(2) {
  [0]=>
  bool(false)
  [1]=>
  int(0)
}

    Примечания

    Замечание:

    Если функция имеет аргументы, которые должны быть ссылками, то они должны быть ссылками и в переданном спике аргументов.

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

    add a note add a note

    User Contributed Notes 2 notes

    up
    0
    theyourcomputer at gmail dot com
    7 years ago
    In the case of call_user_func_array(), if you were to pass around an anonymous function and reference $this within the anonymous function, $this will faithfully refer to the class in the context in which the function was defined. Using ReflectionFunction::invokeArgs() does not seem to retain its original context--yeah, even if you bind the anonymous function before invoking. I recommend call_user_func_array() where context is a concern.
    up
    0
    Andrea Giammarchi
    16 years ago
    I encountered a weird problem with ReflectionFunction, described in ticket 44139 of PHP Bugs.

    If for some reason you need to call with invoke, or invokeArgs, a function like array_unshift (that accepts internally the array by reference) you could use this code to avoid the generated warning or fatal error.

    <?php
    function unshift(){
            $ref        = new ReflectionFunction('array_unshift');
            $arguments    = func_get_args();
        return            $ref->invokeArgs(array_merge(array(&$this->arr), $arguments));
    }
    ?>

    I don't know about performances (you can create an array manually too, starting from array(&$this->something) and adding arguments). However, it seems to work correctly without problems, at least until the send by reference will be usable with one single value ...
    add a note add a note
    To Top