ReflectionFunction::invokeArgs

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

ReflectionFunction::invokeArgs — Invoque les arguments d'une fonction

Description

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

Invoque la fonction et lui transmet les arguments sous la forme d'un tableau.

Liste de paramètres

args: Les arguments à utiliser lors de l'invocation, tout comme le fonctionnement de call_user_func_array().

Valeurs de retour

Retourne le résultat de la fonction invoquée.

Historique

Version	Description
8.0.0	Les clés de `args` seront désormais interprété comme les noms des paramètres, au lieu d'être silencieusement ignoré.

Exemples

Exemple #1 Exemple avec 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'));
?>

L'exemple ci-dessus va afficher :

Dr. Phil

Exemple #2 Exemple pour ReflectionFunction::invokeArgs() avec des références

<?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);
?>

L'exemple ci-dessus va afficher :

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

Notes

Note:
Si la fonction a des arguments qui ont besoin d'être des références, alors ils doivent être passés par références dans la liste des arguments.

Voir aussi

ReflectionFunction::invoke() - Invoque une fonction
ReflectionFunctionAbstract::getNumberOfParameters() - Récupère le nombre de paramètres
__invoke()
call_user_func_array() - Appelle une fonction de rappel avec les paramètres rassemblés en tableau

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

＋add a note

User Contributed Notes 2 notes

down

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.

down

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