ReflectionMethod::invokeArgs

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

ReflectionMethod::invokeArgs — 带参数执行

说明

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

使用数组给方法传送参数，并执行他。

参数

object: 调用方法的对象，如果是静态对象，设置为 null
args: 使用 array 传送的方法参数。

返回值

返回方法返回值。

错误／异常

如果 object 指定的实例无法执行方法，那么产生 ReflectionException 异常。

如果方法调用失败，产生 ReflectionException

更新日志

版本	说明
8.0.0	`args` 的键现在将解释为参数的名称，而不是默默忽略。

示例

示例 #1 ReflectionMethod::invokeArgs() 示例

<?php
class HelloWorld {

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

}

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

以上示例会输出：

Hello Mike

注释

注意:
如果函数有参数需为引用，那么它们必须以引用方式传入。

参见

ReflectionMethod::invoke() - Invoke
__invoke()
call_user_func_array() - 调用回调函数，并把一个数组参数作为回调函数的参数

发现了问题？

了解如何改进此页面 • 提交拉取请求 • 报告一个错误

＋添加备注

用户贡献的备注 4 notes

down

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

      }

?>

down

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

down

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.

down

cweiske at cweiske dot de ¶

13 years ago

Passing arguments by reference works:
<?php $rm->invokeArgs($object, array(&$foo, $bar)); ?>