ReflectionMethod::invokeArgs

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

ReflectionMethod::invokeArgs — Invoque les arguments

Description

public function 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, il est possible de passer null pour ce paramÚtre.

args

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

Si toutes les clés de args sont numériques, les clés sont ignorées et chaque élément est passé à la méthode comme argument positionnel, dans l'ordre.

Si certaines clés de args sont des chaßnes, ces éléments sont passés à la méthode comme arguments nommés, avec le nom donné par la clé.

Une Error est levée si une clé numérique de args apparaßt aprÚs une clé chaßne, ou si une clé chaßne ne correspond au nom d'aucun paramÚtre de la méthode.

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Ă©es comme les noms des paramĂštres, au lieu d'ĂȘtre silencieusement ignorĂ©es.

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

Found A Problem?

Learn How To Improve This Page ‱ Submit a Pull Request ‱ Report a Bug
add a note

User Contributed Notes 4 notes

up
13
serg dot smertin at gmail dot com ¶
15 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
agent_harris at secure-mail dot biz ¶
15 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.
up
2
CodeCoutureXX at gmail dot com ¶
11 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
-2
cweiske at cweiske dot de ¶
15 years ago
Passing arguments by reference works:
<?php $rm->invokeArgs($object, array(&$foo, $bar)); ?>
add a note