SPL Functions
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
)
class_implements
(PHP 5 >= 5.1.0)
class_implements — Return the interfaces which are implemented by the given class
Description
This function returns an array with the names of the interfaces that the
given class and its parents implement.
Parameters
-
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.
Return Values
An array on success, or FALSE on error.
Changelog
| Version | Description |
|---|---|
| 5.1.0 |
Added the option to pass the class parameter as
a string. Added the autoload parameter.
|
Examples
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));
?>
The above example will output something similar to:
Array
(
[foo] => foo
)
Array
(
[interface_of_not_loaded] => interface_of_not_loaded
)
See Also
- class_parents() - Return the parent classes of the given class
- get_declared_interfaces() - Returns an array of all declared interfaces
add a note
User Contributed Notes
class_implements - [4 notes]
trollll23 at yahoo dot com ¶
7 years ago
ludvig dot ericson at gmail dot nospam dot com ¶
7 years ago
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.
paul at paulferrett dot com ¶
3 years ago
You can also check if a class implements an interface using instanceof.
E.g.
<?php
if($myObj instanceof MyInterface) {
echo "It is! It is!";
}
?>