PHP Conference Japan 2024

    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)

    參見

    發現問題？

    了解如何改進此頁面 • 提交 Pull Request • 回報錯誤
    ＋新增註解

    使用者貢獻的註解 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