class_implements

(PHP 5, PHP 7, PHP 8)

class_implements — Devuelve las interfaces implementadas por una clase o interfaz dada

Descripción

function class_implements(object |string $object_or_class, bool $autoload = true ): array |false

Esta función devuelve un array con los nombres de las interfaces que la clase object_or_class así como sus padres implementan.

Parámetros

object_or_class: Un objeto (instancia) o una cadena de caracteres (nombre de la clase o de la interfaz).
autoload: Define si debe autocargarse si no está ya autocargado.

Valores devueltos

Un array en caso de éxito, o false cuando la clase dada no existe.

Ejemplos

Ejemplo #1 Ejemplo con class_implements()

<?php
interface foo { }
class bar implements foo {}
print_r(class_implements(new bar));
// También se puede especificar el argumento como una cadena de caracteres
print_r(class_implements('bar'));
spl_autoload_register();
// Uso del autoloading para cargar la clase 'not_loaded'
print_r(class_implements('not_loaded', true));
?>

Resultado del ejemplo anterior es similar a:

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

Notas

Nota: Es preferible utilizar instanceof o la función is_a() para verificar que un objeto implementa una interfaz.

Véase también

class_parents() - Devuelve las clases padres de una clase
get_declared_interfaces() - Devuelve un array con todas las interfaces declaradas
is_a() - Verifica si el objeto es de un cierto tipo o subtipo.
instanceof

Found A Problem?

Learn How To Improve This Page • Submit a Pull Request • Report a Bug

+add a note

User Contributed Notes 3 notes

down

ludvig dot ericson at gmail dot nospam dot com ¶

21 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.

down

a dot panek at brainsware dot org ¶

12 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.

down

trollll23 at yahoo dot com ¶

20 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
 )

+add a note