PHP Unconference Europe 2015

class_implements

(PHP 5 >= 5.1.0)

class_implements بازگرداندن واسط که توسط کلاس داده شده پیاده گشته است

Description

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

این تابع آرایه نام واسط‌های پیاده‌سازی شده توسط class داده شده و والدین آن را باز می‌گرداند.

Parameters

class

شی (نمونه کلاس) یا رشته (نام کلاس).

autoload

اجازه به این تابع برای بارگذاری خودکار کلاس از طریق متد جادویی __autoload.

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

add a note add a note

User Contributed Notes 4 notes

up
7
paul at paulferrett dot com
4 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!";
}
?>
up
1
ludvig dot ericson at gmail dot nospam dot com
9 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.
up
1
a dot panek at brainsware dot org
11 months ago
Calling class_implements with a non-loadable class name or a non-object results in a warning:

<?php
// Warning: class_implements(): Class abc does not exist and could not be loaded in /home/a.panek/Projects/sauce/lib/Sauce/functions.php on line 196

$interfaces = class_implements('abc');
?>

This is not documented and should just return FALSE as the documentation above says.
up
-1
trollll23 at yahoo dot com
9 years ago
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
    )
To Top