ReflectionMethod::invokeArgs
(PHP 5 >= 5.1.0, PHP 7)
ReflectionMethod::invokeArgs — Вызов метода с передачей аргументов массивом
Описание
Вызывает отображенный метод и передает ему аргументы в виде массива.
Список параметров
Возвращаемые значения
Возвращает результат выполнения метода.
Ошибки
Вызывает исключение ReflectionException, если в объекте
object
нет определения этого метода.
Вызывает исключение ReflectionException, если вызвать метод на исполнение не удалось.
Примеры
Пример #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()
- call_user_func_array() - Вызывает пользовательскую функцию с массивом параметров
- PHP Руководство
- Функции по категориям
- Индекс функций
- Справочник функций
- Расширения, относящиеся к переменным и типам
- Reflection
- Функция ReflectionMethod::__construct() - Конструктор класса ReflectionMethod
- Функция ReflectionMethod::export() - Экспорт отраженного метода
- Функция ReflectionMethod::getClosure() - Возвращает динамически созданное замыкание для метода
- Функция ReflectionMethod::getDeclaringClass() - Получает класс, объявляющий отображенный метод
- Функция ReflectionMethod::getModifiers() - Получает модификаторы метода
- Функция ReflectionMethod::getPrototype() - Получает прототип метода (если такой есть)
- Функция ReflectionMethod::invoke() - Вызов
- Функция ReflectionMethod::invokeArgs() - Вызов метода с передачей аргументов массивом
- Функция ReflectionMethod::isAbstract() - Проверяет, является ли метод абстрактным
- Функция ReflectionMethod::isConstructor() - Проверяет, является ли метод конструктором
- Функция ReflectionMethod::isDestructor() - Проверяет, является ли метод деструктором
- Функция ReflectionMethod::isFinal() - Проверяет, может ли метод иметь наследников (final)
- Функция ReflectionMethod::isPrivate() - Проверяет, является ли метод частным (private)
- Функция ReflectionMethod::isProtected() - Проверяет, является ли метод защищенным (protected)
- Функция ReflectionMethod::isPublic() - Проверяет, является ли метод общедоступным (public)
- Функция ReflectionMethod::isStatic() - Проверяет, является ли метод статическим
- Функция ReflectionMethod::setAccessible() - Делает метод доступным
- Функция ReflectionMethod::__toString() - Возвращает строковое представление объекта Reflection method
Коментарии
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);
}
?>
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.
Passing arguments by reference works:
<?php $rm->invokeArgs($object, array(&$foo, $bar)); ?>
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