(PHP 5, PHP 7, PHP 8)
class_implements — 与えられたクラスあるいはインターフェイスが実装しているインターフェイスを返す
この関数は、与えられたクラス object_or_class
とその親が実装しているインターフェイスを配列で返します。
object_or_classオブジェクト (クラスのインスタンス) もしくは文字列 (クラス名あるいはインターフェイス名) を指定します。
autoloadまだロードされていない場合に オートロード するかどうか。
成功した場合に配列、
指定されたクラスが存在しない場合に false を返します。
例1 class_implements() の例
<?php
interface foo { }
class bar implements foo {}
print_r(class_implements(new bar));
// パラメータを文字列として指定しても良い
print_r(class_implements('bar'));
spl_autoload_register();
// 'not_loaded' クラスをロードするためにオートローディングを使用する
print_r(class_implements('not_loaded', true));
?>上の例の出力は、 たとえば以下のようになります。
Array
(
[foo] => foo
)
Array
(
[foo] => foo
)
Array
(
[interface_of_not_loaded] => interface_of_not_loaded
)
注意: オブジェクトが、インターフェイスを実装しているかどうかを調べるには、
instanceofか、is_a() 関数を代わりに使うべきです。
instanceofHint:
<?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.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.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
)