class_implements

(PHP 5 >= 5.1.0)

class_implements — Return the interfaces which are implemented by the given class

Описание

array class_implements ( mixed $class [, bool $autoload = true ] )

This function returns an array with the names of the interfaces that the given class and its parents implement.

Параметри

class: An object (class instance) or a string (class name).
autoload: Whether to allow this function to load the class automatically through the __autoload magic method. Defaults to TRUE.

Връщани стойности

An array on success, or FALSE on error.

Дневник на промените

Версия	Описание
5.1.0	Added the option to pass the `class` parameter as a string. Added the `autoload` parameter.

Примери

Example #1 class_implements() example


<?php

interface foo { }
class bar implements foo {}

print_r(class_implements(new bar));

// since PHP 5.1.0 you may also specify the parameter as a string
print_r(class_implements('bar'));


function __autoload($class_name) {
   require_once $class_name . '.php';
}

// use __autoload to load the 'not_loaded' class
print_r(class_implements('not_loaded', true));

?>

Примерът по-горе ще изведе нещо подобно на:

Array
(
    [foo] => foo
)

Array
(
    [interface_of_not_loaded] => interface_of_not_loaded
)

Вж. също

class_parents() - Return the parent classes of the given class
get_declared_interfaces() - Връща масив с всички декларирани интерфейси

class_parents

SPL Функции

[edit] Last updated: Fri, 18 Sep 2009

add a note User Contributed Notes class_implements

paul at paulferrett dot com 30-Dec-2009 10:35


You can also check if a class implements an interface using instanceof.



E.g.

<?php

if($myObj instanceof MyInterface) {

    echo "It is! It is!";

}

?>

24-Jan-2006 02:51


You can use Reflection class instead:



<?php



$r = new ReflectionClass($class);

foreach($r->getInterfaces() as $in)

{

  $in->getName();

}

trollll23 at yahoo dot com 25-Oct-2005 06:57


Luckily, it prints out superinterfaces as well in reverse order so iterative searching works fine:



    <?php

    

    interface InterfaceA { }

    

    interface InterfaceB extends InterfaceA { }

    

    class MyClass implements InterfaceB { }

    

    print_r(class_implements(new MyClass()));

    

    ?>



prints out:



    Array

    (

        [InterfaceB] => InterfaceB

        [InterfaceA] => InterfaceA

    )

ludvig dot ericson at gmail dot nospam dot com 01-Aug-2005 06:41


Hint:

<?php

in_array("your-interface", class_implements($object_or_class_name));

?>

would check if 'your-interface' is ONE of the implemented interfaces.

Note that you can use something similar to be sure the class only implements that, (whyever you would want that?)

<?php

array("your-interface") == class_implements($object_or_class_name);

?>



I use the first technique to check if a module has the correct interface implemented, or else it throws an exception.

add a note