is_subclass_of

    (PHP 4, PHP 5, PHP 7, PHP 8)

    is_subclass_of — 检查对象是否具有此类作为其父类之一或实现它

    描述

    is_subclass_of(混合 $object_or_class, 字符串 $class, 布尔 $allow_string = true): 布尔

    检查给定的 object_or_class 是否具有类 class 作为其父类之一或实现它。

    参数

    object_or_class

    类名或对象实例。如果类不存在，不会产生错误。

    class

    类名

    allow_string

    如果此参数设置为 false，则不允许字符串类名作为 object_or_class。这也将阻止调用自动加载器，如果类不存在。

    返回值

    如果对象 object_or_class 属于 class 的子类，此函数返回 true，否则返回 false。

    示例

    示例 #1 is_subclass_of() 示例

    <?php
    // 定义一个类
    class WidgetFactory
    {
    var     $oink = 'moo';
    }

    // 定义一个子类
    class WidgetFactory_Child extends WidgetFactory
    {
    var     $oink = 'oink';
    }

    // 创建一个新对象
    $WF = new WidgetFactory();
    $WFC = new WidgetFactory_Child();

    if (    is_subclass_of($WFC, 'WidgetFactory')) {
    echo     "是的，\$WFC 是 WidgetFactory 的子类\n";
    } else {
    echo     "不，\$WFC 不是 WidgetFactory 的子类\n";
    }


    if (    is_subclass_of($WF, 'WidgetFactory')) {
    echo     "是的，\$WF 是 WidgetFactory 的子类\n";
    } else {
    echo     "不，\$WF 不是 WidgetFactory 的子类\n";
    }


    if (    is_subclass_of('WidgetFactory_Child', 'WidgetFactory')) {
    echo     "是的，WidgetFactory_Child 是 WidgetFactory 的子类\n";
    } else {
    echo     "不，WidgetFactory_Child 不是 WidgetFactory 的子类\n";
    }
    ?>

    上面的例子将输出

    yes, $WFC is a subclass of WidgetFactory
no, $WF is not a subclass of WidgetFactory
yes, WidgetFactory_Child is a subclass of WidgetFactory

    示例 #2 使用接口的 is_subclass_of() 示例

    <?php
    // 定义接口
    interface MyInterface
    {
    public function     MyFunction();
    }

    // 定义类对接口的实现
    class MyClass implements MyInterface
    {
    public function     MyFunction()
    {
    return     "MyClass Implements MyInterface!";
    }
    }

    // 实例化对象
    $my_object = new MyClass;

    // 从 5.3.7 开始有效

    // 使用类的对象实例进行测试
    if (is_subclass_of($my_object, 'MyInterface')) {
    echo     "是的，\$my_object 是 MyInterface 的子类\n";
    } else {
    echo     "不，\$my_object 不是 MyInterface 的子类\n";
    }

    // 使用类名的字符串进行测试
    if (is_subclass_of('MyClass', 'MyInterface')) {
    echo     "是的，MyClass 是 MyInterface 的子类\n";
    } else {
    echo     "不，MyClass 不是 MyInterface 的子类\n";
    }
    ?>

    上面的例子将输出

    Yes, $my_object is a subclass of MyInterface
Yes, MyClass is a subclass of MyInterface

    注释

    注意:

    使用此函数将使用任何已注册的 自动加载器，如果类尚不清楚。

    参见

    改进此页面

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

    用户贡献的注释 3 个注释

    17
    gunniboyh at web dot de
    18 年前
    is_subclass_of() 也适用于 obj 类和超类之间的类。

    示例
    <?php
    class A {};
    class     B extends A {};
    class     C extends B {};

    $foo=new C();
    echo ((    is_subclass_of($foo,'A')) ? 'true' : 'false');
    ?>

    输出 'true'。
    10
    nicholas at aquarionics dot com
    15 年前
    这可能对某些人有用，所以

    如果您使用的是自动加载，您应该知道这将尝试自动加载 $classname（如果尚未加载）。我在自动加载抛出的错误中使用 is_subclass_of 时发现了这一点，它会一直递归直到内存不足。
    2
    alan at jynxy.net
    6 年前
    参数 $allow_string 的文档说明不太清楚。当为 true 时，它只是允许第一个参数是类的名称，而不是我们感兴趣的类的对象。

    一些使用示例

    class parent_class {
    // 对象和方法 ...
    }

    $possible_child_object = new possible_child_class(); // 可能扩展了 parent_class

    $result = is_subclass_of($possible_child_object, 'parent_class'); // 有效
    $result = is_subclass_of($possible_child_object, 'parent_class', false); // 有效
    $result = is_subclass_of('possible_child_class', 'parent_class', true); // 有效
    $result = is_subclass_of('possible_child_class', 'parent_class', false); // 无效
    ＋添加注释
    To Top