PHP is developed and maintained by a global community of contributors.
The PHP Foundation helps fund this work. If PHP is part of your business or projects, consider sponsoring the Foundation.
(PHP 5 >= 5.1.3, PHP 7, PHP 8)
ReflectionClass::newInstanceArgs — Creates a new class instance from given arguments
Creates a new instance of the class, the given arguments are passed to the class constructor.
argsThe parameters to be passed to the class constructor as an array.
If the keys of args are all numeric, the keys are
ignored and each element is passed to the constructor as a positional
argument, in order.
If any keys of args are strings, those elements are
passed to the constructor as named arguments, with the name given by the
key.
An Error is thrown if a numeric key in
args appears after a string key, or if a string key
does not match the name of any constructor parameter.
Returns a new instance of the class, or null on failure.
A ReflectionException if the class constructor is not public.
A ReflectionException if the class does not have a constructor
and the args parameter contains one or more parameters.
| Version | Description |
|---|---|
| 8.0.0 |
args keys will now be interpreted as parameter names, instead of being silently ignored.
|
Example #1 Basic usage of ReflectionClass::newInstanceArgs()
<?php
$class = new ReflectionClass('ReflectionFunction');
$instance = $class->newInstanceArgs(array('substr'));
var_dump($instance);
?>The above example will output:
object(ReflectionFunction)#2 (1) {
["name"]=>
string(6) "substr"
}
