Edit Report a Bug

    ReflectionMethod::invokeArgs

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

    ReflectionMethod::invokeArgs — Invoque les arguments

    Description

    public ReflectionMethod::invokeArgs(?object $object, array $args): mixed

    Invoque la méthode réfléchie et lui passe les arguments sous la forme d'un tableau.

    Liste de paramètres

    object

    L'objet sur lequel invoquer la méthode. Si la méthode est statique, vous pouvez passer null pour ce paramètre.

    args

    Les paramètres à passer à la méthode, sous forme de tableau.

    Valeurs de retour

    Retourne le résultat de la méthode.

    Erreurs / Exceptions

    Une ReflectionException si object n'est pas une instance de la classe prévue pour cette méthode.

    Une ReflectionException si l'invocation de la méthode échoue.

    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 pour ReflectionMethod::invokeArgs()

    <?php
    class HelloWorld {

    public function     sayHelloTo($name) {
    return     'Hello ' . $name;
    }

    }

    $reflectionMethod = new ReflectionMethod('HelloWorld', 'sayHelloTo');
    echo     $reflectionMethod->invokeArgs(new HelloWorld(), array('Mike'));
    ?>

    L'exemple ci-dessus va afficher :

    Hello Mike

    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

    add a note add a note

    User Contributed Notes 4 notes

    up
    13
    serg dot smertin at gmail dot com
    14 years ago
    We can do black magic, which is useful in templating block calls:

    <?php
         $object    ->__named('methodNameHere', array('arg3' => 'three', 'arg1' => 'one'));

         ...

              /**
           * Pass method arguments by name
           *
           * @param string $method
           * @param array $args
           * @return mixed
           */
              public function __named($method, array $args = array())
          {
                $reflection = new ReflectionMethod($this, $method);

                $pass = array();
            foreach(    $reflection->getParameters() as $param)
            {
                  /* @var $param ReflectionParameter */
                  if(isset($args[$param->getName()]))
              {
                    $pass[] = $args[$param->getName()];
              }
              else
              {
                    $pass[] = $param->getDefaultValue();
              }
            }

            return     $reflection->invokeArgs($this, $pass);
          }
    ?>
    up
    4
    cweiske at cweiske dot de
    13 years ago
    Passing arguments by reference works:
    <?php $rm->invokeArgs($object, array(&$foo, $bar)); ?>
    up
    3
    CodeCoutureXX at gmail dot com
    9 years ago
    If you need to call ReflectionMethod::invokeArgs() on a static function you can pass NULL in for the $object parameter.

    Example:

    <?php
             class myClass {
              public static     myStaticFunc($a, $b) {
                   return     $a + $b;
              }
         }

             $ref = new ReflectionMethod('myClass', 'myStaticFunc');
         echo     $ref->invokeArgs(NULL, [12, 7]);
    ?>

    produces the following output:

    19
    up
    1
    agent_harris at secure-mail dot biz
    13 years ago
    There is a simple workaround for the reference passing problem:
    Since the reflection api has to handle all parameters in a generic way it has no chance to guess if you wish to pass data per value or reference.

    But it seems that you can also decide to pass a reference from where you call the function or method (not just only by the ampersand prefix in its declaration).

    So just do the following; which worked for me:

    <?php
    //...
    $method->invoke($object, $inputValue, &$outputValue);
    ?>

    Since this will only be necessary with arrays and primitive data types it should be acceptable in most cases to know in advance if you need to pass per reference. But it is probably although necessary to keep the ampersand always in the declaration (because of the at least two layers between the actual function and your invoke call).

    If this is the expected behavior it will maybe make sense to mention it in the documentation for invoke and invokeArgs.
    add a note add a note
    To Top