Rechercher une fonction PHP

is_subclass_of

(PHP 4, PHP 5, PHP 7)

is_subclass_ofChecks if the object has this class as one of its parents or implements it

Description

is_subclass_of ( mixed $object , string $class_name [, bool $allow_string = TRUE ] ) : bool

Checks if the given object has the class class_name as one of its parents or implements it.

PHP: is_subclass_of - Manual Home of Manuel PHP  Contents Haut

Parameters

object

A class name or an object instance. No error is generated if the class does not exist.

class_name

The class name

allow_string

If this parameter set to false, string class name as object is not allowed. This also prevents from calling autoloader if the class doesn't exist.

PHP: is_subclass_of - Manual Home of Manuel PHP  Contents Haut

Return Values

This function returns TRUE if the object object, belongs to a class which is a subclass of class_name, FALSE otherwise.

PHP: is_subclass_of - Manual Home of Manuel PHP  Contents Haut

Changelog

Version Description
5.3.9 Added allow_string parameter
5.3.7 Added support for class_name to work with interfaces
5.0.3 You may also specify the object parameter as a string (the name of the class)

PHP: is_subclass_of - Manual Home of Manuel PHP  Contents Haut

Examples

Example #1 is_subclass_of() example

<?php
// define a class
class WidgetFactory
{
  var 
$oink 'moo';
}

// define a child class
class WidgetFactory_Child extends WidgetFactory
{
  var 
$oink 'oink';
}

// create a new object
$WF = new WidgetFactory();
$WFC = new WidgetFactory_Child();

if (
is_subclass_of($WFC'WidgetFactory')) {
  echo 
"yes, \$WFC is a subclass of WidgetFactory\n";
} else {
  echo 
"no, \$WFC is not a subclass of WidgetFactory\n";
}


if (
is_subclass_of($WF'WidgetFactory')) {
  echo 
"yes, \$WF is a subclass of WidgetFactory\n";
} else {
  echo 
"no, \$WF is not a subclass of WidgetFactory\n";
}


// usable only since PHP 5.0.3
if (is_subclass_of('WidgetFactory_Child''WidgetFactory')) {
  echo 
"yes, WidgetFactory_Child is a subclass of WidgetFactory\n";
} else {
  echo 
"no, WidgetFactory_Child is not a subclass of WidgetFactory\n";
}
?>

The above example will output:

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

Example #2 is_subclass_of() using interface example

<?php
// Define the Interface
interface MyInterface
{
  public function 
MyFunction();
}

// Define the class implementation of the interface
class MyClass implements MyInterface
{
  public function 
MyFunction()
  {
    return 
"MyClass Implements MyInterface!";
  }
}

// Instantiate the object
$my_object = new MyClass;

// Works since 5.3.7

// Test using the object instance of the class
if (is_subclass_of($my_object'MyInterface')) {
  echo 
"Yes, \$my_object is a subclass of MyInterface\n";
} else {
  echo 
"No, \$my_object is not a subclass of MyInterface\n";
}

// Test using a string of the class name
if (is_subclass_of('MyClass''MyInterface')) {
  echo 
"Yes, MyClass is a subclass of MyInterface\n";
} else {
  echo 
"No, MyClass is not a subclass of MyInterface\n";
}
?>

The above example will output:

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

PHP: is_subclass_of - Manual Home of Manuel PHP  Contents Haut

Notes

Note:

Using this function will use any registered autoloaders if the class is not already known.

PHP: is_subclass_of - Manual Home of Manuel PHP  Contents Haut

See Also

  • get_class() - Returns the name of the class of an object
  • get_parent_class() - Retrieves the parent class name for object or class
  • is_a() - Checks if the object is of this class or has this class as one of its parents
  • class_parents() - Return the parent classes of the given class

Find a PHP function

English translation

You have asked to visit this site in English. For now, only the interface is translated, but not all the content yet.

If you want to help me in translations, your contribution is welcome. All you need to do is register on the site, and send me a message asking me to add you to the group of translators, which will give you the opportunity to translate the pages you want. A link at the bottom of each translated page indicates that you are the translator, and has a link to your profile.

Thank you in advance.

Document created the 30/01/2003, last modified the 26/10/2018
Source of the printed document:https://www.gaudry.be/en/php-rf-function.is-subclass-of.html

The infobrol is a personal site whose content is my sole responsibility. The text is available under CreativeCommons license (BY-NC-SA). More info on the terms of use and the author.

References

  1. View the html document Language of the document:fr Manuel PHP : http://php.net

These references and links indicate documents consulted during the writing of this page, or which may provide additional information, but the authors of these sources can not be held responsible for the content of this page.
The author This site is solely responsible for the way in which the various concepts, and the freedoms that are taken with the reference works, are presented here. Remember that you must cross multiple source information to reduce the risk of errors.

Contents Haut