PHP 8.5.0 Alpha 2 available for testing

ReflectionMethod::invokeArgs

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

ReflectionMethod::invokeArgsInvoca los argumentos

Descripción

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

Invoca el método reflejado y le pasa los argumentos en forma de array.

Parámetros

object

El objeto sobre el cual invocar el método. Si el método es estático, puede pasarse null para este argumento.

args

Los argumentos a pasar al método, en forma de array.

Valores devueltos

Devuelve el resultado del método.

Errores/Excepciones

Una ReflectionException si object no es una instancia de la clase prevista para este método.

Una ReflectionException si la invocación del método falla.

Historial de cambios

Versión Descripción
8.0.0 Las claves de args serán interpretadas como los nombres de los argumentos, en lugar de ser ignoradas silenciosamente.

Ejemplos

Ejemplo #1 Ejemplo para ReflectionMethod::invokeArgs()

<?php
class HelloWorld {

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

}

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

El ejemplo anterior mostrará :

Hello Mike

Notas

Nota:

Si la función tiene argumentos que necesitan ser referencias, entonces deben ser pasados por referencia en la lista de argumentos.

Ver también

add a note

User Contributed Notes 4 notes

up
12
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
agent_harris at secure-mail dot biz
14 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
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
0
cweiske at cweiske dot de
14 years ago
Passing arguments by reference works:
<?php $rm->invokeArgs($object, array(&$foo, $bar)); ?>
To Top