class_implements

(PHP 5, PHP 7, PHP 8)

class_implements Retourne les interfaces implémentées par une classe ou une interface donnée

Description

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

Cette fonction retourne un tableau avec les noms des interfaces que la classe class ainsi que ses parents implémentent.

Liste de paramètres

class

Un objet (instance) ou une chaîne de caractères (nom de la classe ou de l'interface).

autoload

Si true, autorise cette fonction à charger la classe automatiquement grâce à la méthode magique __autoload().

Valeurs de retour

Retourne un tableau ou false en cas d'erreur.

Exemples

Exemple #1 Exemple avec class_implements()

<?php

interface foo { }
class 
bar implements foo {}

print_r(class_implements(new bar));

// vous pouvez aussi spécifier le paramètre comme une chaîne de caractères
print_r(class_implements('bar'));


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

// Utilisez __autoload pour charger la classe 'non_chargée'
print_r(class_implements('non_chargée'true));

?>

Résultat de l'exemple ci-dessus est similaire à :

Array
(
    [foo] => foo
)

Array
(
    [interface_de_non_chargée] => interface_de_non_chargée
)

Voir aussi

add a note add a note

User Contributed Notes 5 notes

up
48
paul at paulferrett dot com
14 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
13
ludvig dot ericson at gmail dot nospam dot com
18 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
6
a dot panek at brainsware dot org
10 years 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
2
trollll23 at yahoo dot com
18 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
    )
up
-2
sam at rmcreative dot ru
5 years ago
The order of interfaces is not reliable and varies between PHP versions.
To Top