class_implements

(PHP 5, PHP 7, PHP 8)

class_implements — Devuelve las interfaces que son implementadas por la clase o interfaz dadas

Descripción

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

Esta función devuelve un array con los nombres de las interfaces que implementa la class dada y sus padres.

Parámetros

class: Un objeto (instancia de clase) o un string (nombre de clase o interfaz).
autoload: Establece si se va a permitir que la clase se cargue automáticamente a a través del método mágico __autoload().

Valores devueltos

Un array en caso de éxito, o false en caso de error.

Historial de cambios

Versión	Descripción
5.1.0	Añadida la opción para pasar el parámetro `class` como un string. Añadido el parámetro `autoload`.

Ejemplos

Ejemplo #1 Ejemplo de class_implements()

<?php

interface foo { }
class bar implements foo {}

print_r(class_implements(new bar));

// desde PHP 5.1.0 se puede especificar el parámetro como un string
print_r(class_implements('bar'));


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

// uso de __autoload para cargar la clase 'not_loaded'
print_r(class_implements('not_loaded', true));

?>

El resultado del ejemplo sería algo similar a:

Array
(
    [foo] => foo
)

Array
(
    [interface_of_not_loaded] => interface_of_not_loaded
)

Ver también

class_parents() - Devuelve las clases padre de la clase dada.
get_declared_interfaces() - Devuelve un array con todas las interfaces declaradas

Improve This Page

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 ¶

19 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 ¶

11 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 ¶

19 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