class_implements

(PHP 5)

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

说明

array class_implements ( mixed class [, bool autoload] )

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.

返回值

Returns an array or FALSE on error.

更新日志

版本说明
5.1.0 Added the option to pass the class parameter as a string. Added the autoload parameter.

范例

例子 1. class_implements() example

<?php

interface foo
{ }
class
bar implements foo {}

print_r(class_implements(new bar));

// since PHP 5.1 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
)


add a note add a note User Contributed Notes
25-Jan-2006 01:51
You can use Reflection class instead:

<?php

$r
= new ReflectionClass($class);
foreach(
$r->getInterfaces() as $in)
{
 
$in->getName();
}
trollll23 at yahoo dot com
26-Oct-2005 03: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
02-Aug-2005 03: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.