ReflectionClass::newInstance

(PHP 5, PHP 7, PHP 8)

ReflectionClass::newInstanceCreates a new class instance from given arguments

Description

public ReflectionClass::newInstance(mixed ...$args): object

Creates a new instance of the class. The given arguments are passed to the class constructor.

Parameters

args

Accepts a variable number of arguments which are passed to the class constructor, much like call_user_func().

Return Values

Errors/Exceptions

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.

See Also

add a note add a note

User Contributed Notes 2 notes

up
0
feryardiant at pm dot me
2 years ago
I don't know why it's not documented anywhere, when you (accidentally) pass an abstract class name you'll get the instance of Error class instead of ReflectionException class.

<?php
function reflect(string $class) {
    try {
        (new
ReflectionClass($class))->newInstance();
    } catch (
Throwable $e) {
        echo
get_class($e) . ' : ' . $e->getMessage() . PHP_EOL;
    }
}

abstract class
A {}

class
B {
    private function
__construct() {}
}

reflect(A::class); // => Error : Cannot instantiate abstract class A
reflect(B::class); // => ReflectionException : Access to non-public constructor of class B
up
-5
glen at delfi dot ee
8 years ago
looks like reflection class newInstance creates in memory representation of code where values are used, so using reference as constructor signature, you can not use this method.

as  the same input if called via new, or new $class works, but not via reflection:

class a {
     public function __construct(&$a, $c) {
     }
}

// this works
$A = new stdClass();
$a = new a($A, 11);

// also this works
$classname = "a";
$a = new $classname($A, 10);

// but this fails:
$r = new ReflectionClass("a");
$r->newInstance($A, 10);

PHP Warning:  Parameter 1 to a::__construct() expected to be a reference, value given in reflection.php on line 15

PHP Warning:  ReflectionClass::newInstance(): Invocation of a's constructor failed in reflection.php on line 15
To Top