ReflectionClass::isInstantiable

    (PHP 5, PHP 7, PHP 8)

    ReflectionClass::isInstantiable — 检查类是否可实例化

    描述

    public ReflectionClass::isInstantiable(): bool

    检查类是否可实例化。

    参数

    此函数没有参数。

    返回值

    如果成功则返回 true，如果失败则返回 false。

    示例

    示例 #1 ReflectionClass::isInstantiable() 示例

    <?php
    class C { }

    interface     iface {
    function     f1();
    }

    class     ifaceImpl implements iface {
    function     f1() {}
    }

    abstract class     abstractClass {
    function     f1() { }
    abstract function     f2();
    }

    class     D extends abstractClass {
    function     f2() { }
    }

    trait     T {
    function     f1() {}
    }

    class     privateConstructor {
    private function     __construct() { }
    }

    $classes = array(
    "C",
    "iface",
    "ifaceImpl",
    "abstractClass",
    "D",
    "T",
    "privateConstructor",
    );

    foreach(    $classes as $class ) {
    $reflectionClass = new ReflectionClass($class);
    echo     "Is $class instantiable? ";
    var_dump($reflectionClass->isInstantiable());
    }

    ?>

    上面的例子将会输出

    Is C instantiable?  bool(true)
Is iface instantiable?  bool(false)
Is ifaceImpl instantiable?  bool(true)
Is abstractClass instantiable?  bool(false)
Is D instantiable?  bool(true)
Is T instantiable?  bool(false)
Is privateConstructor instantiable?  bool(false)

    参见

    改进此页面

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

    用户贡献的备注 1 个备注

    3
    shaun at slickdesign dot com dot au
    6 年前
    文档中缺少的一个示例是，`ReflectionClass::isInstantiable` 也会对 traits、接口和抽象类返回 false。

    <?php
    trait t {
    // 可选的 trait 方法和属性等
    }

    $reflectionClass = new ReflectionClass("t");
    var_dump($reflectionClass->isInstantiable()); // bool(false)
    ?>

    对于具有私有构造函数的类，仍然可以通过两种方法创建实例：使用 `ReflectionClass::newInstanceWithoutConstructor` 绕过构造函数，或者确保类具有可以创建新实例的方法。

    <?php
    class p {
    private function     __construct() {
    // 可选的构造函数逻辑 - 当使用 ReflectionClass::newInstanceWithoutConstructor 时不会被调用。
    }

    public static function     create() {
    return new     p;
    }

    // 可选的方法和属性等
    }

    // 类不被视为可实例化。
    $reflectionClass = new ReflectionClass("p");
    var_dump($reflectionClass->isInstantiable()); // bool(false)

    // 我们仍然可以使用两种方法之一创建实例。
    $p = p::create();
    $p = $reflectionClass->newInstanceWithoutConstructor();
    ?>

    对于受保护的构造函数也是如此，但是，可以从父方法或子方法中实例化类，具体取决于构造函数的定义位置。

    <?php
    class p {
    protected function     __construct() {
    // 可选的构造函数逻辑。
    }

    public static function     create( $class = "" ) {
    if (!    $class) {
    $class = get_called_class();
    }
    return new     $class;
    }

    // 可选的父方法和属性等
    }

    class     c extends p
    {
    // 可选的子方法和属性等
    }

    // 子静态方法和父静态方法都可以访问彼此的受保护构造函数。
    $p = c::create("p");
    $c = p::create("c");

    // 两者仍然不被视为可实例化的。
    $reflectionClassP = new ReflectionClass("p");
    $reflectionClassC = new ReflectionClass("c");
    var_dump($reflectionClassP->isInstantiable()); // bool(false)
    var_dump($reflectionClassC->isInstantiable()); // bool(false)

    // 我们仍然可以绕过构造函数并为每个创建实例。
    $p = $reflectionClassP->newInstanceWithoutConstructor();
    $c = $reflectionClassC->newInstanceWithoutConstructor();
    ?>
    ＋添加一个备注
    To Top