interface_exists
As of PHP 5.3.9, is_a() seems to return false when passed a string for the first argument. Instead, use is_subclass_of() and, if necessary for your purposes, also check if the two arguments are equal, since is_subclass_of('foo', 'foo') will return false, while is_a('foo', 'foo') used to return true.
is_a
(PHP 4 >= 4.2.0, PHP 5)
is_a — オブジェクトがこのクラスのものであるか、このクラスをその親クラスのひとつとしているかどうかを調べる
説明
bool is_a
( object
$object
, string $class_name
[, bool $allow_string = FALSE
] )
指定した object
がこのクラスのものであるか、
あるいはこのクラスをその親クラスのひとつとしているかどうかを調べます。
パラメータ
-
object -
調べたいオブジェクト。
-
class_name -
クラス名。
-
allow_string -
このパラメータを false にすると、 クラス名を表す文字列を
objectに指定できなくなります。 そして、クラスが存在しない場合のオートローダーの呼び出しもしなくなります。
返り値
オブジェクトがこのクラスのものであるか、
あるいはこのクラスをその親クラスのひとつとしている場合に
TRUE、それ以外の場合に FALSE を返します。
変更履歴
| バージョン | 説明 |
|---|---|
| 5.3.9 |
パラメータ allow_string が追加されました。
|
| 5.3.0 |
この関数は非推奨ではなくなりました。そのため
E_STRICT も発生しなくなりました。
|
| 5.0.0 |
この関数は非推奨となり、かわりに
instanceof
演算子の使用が推奨されるようになりました。この関数をコールすると
E_STRICT が発生します。
|
例
例1 is_a() の例
<?php
// クラス定義
class WidgetFactory
{
var $oink = 'moo';
}
// オブジェクトを作成します
$WF = new WidgetFactory();
if (is_a($WF, 'WidgetFactory')) {
echo "はい、\$WF は WidgetFactory です\n";
}
?>
例2 PHP 5 での instanceof 演算子の使用
<?php
if ($WF instanceof WidgetFactory) {
echo 'はい、$WF は WidgetFactory です';
}
?>
参考
- get_class() - オブジェクトのクラス名を返す
- get_parent_class() - オブジェクトの親クラスの名前を取得する
- is_subclass_of() - あるオブジェクトが指定したクラスのサブクラスに属するかどうかを調べる
add a note
User Contributed Notes
is_a
eitan at mosenkis dot net
12-Jan-2012 01:09
Aron Budinszky
07-Sep-2011 04:21
Be careful! Starting in PHP 5.3.7 the behavior of is_a() has changed slightly: when calling is_a() with a first argument that is not an object, __autoload() is triggered!
In practice, this means that calling is_a('23', 'User'); will trigger __autoload() on "23". Previously, the above statement simply returned 'false'.
More info can be found here:
https://bugs.php.net/bug.php?id=55475
Whether this change is considered a bug and whether it will be reverted or kept in future versions is yet to be determined, but nevertheless it is how it is, for now...
p dot scheit at zweipol dot net
16-Jan-2007 01:44
At least in PHP 5.1.6 this works as well with Interfaces.
<?php
interface test {
public function A();
}
class TestImplementor implements test {
public function A () {
print "A";
}
}
$testImpl = new TestImplementor();
var_dump(is_a($testImpl,'test'));
?>
will return true
martin dunisch
13-Feb-2006 12:02
Workaround for older PHP-Versions:
function is_a($anObject, $aClass) {
return get_class($anObject) == strtolower($aClass)
or is_subclass_of($anObject, $aClass);
}
dead dot screamer at seznam dot cz
06-Feb-2006 11:44
Why I test if class `A` inherit class `B` or implements interface `C` before I create class `A`?
<?
//That isn't work:
//1. function is_A()
if(is_A('A','B'))$a=new A;
if(is_A('A','C'))$a=new A;
//2. operator instanceOf
if(A instanceOf B)$a=new A;
if(A instanceOf C)$a=new A;
?>
zabmilenko at hotmail dot com
07-Oct-2005 05:18
Lazy Instantiation using is_a() and php5
<?php
class ObjectA
{
public function print_line($text)
{
print $text . "\n";
}
}
class ObjectB
{
public function ObjectA()
{
static $objecta;
if (!is_a($objecta, 'ObjectA'))
{
$objecta = new ObjectA;
}
return $objecta;
}
}
$obj = new ObjectB;
$obj->ObjectA()->print_line('testing, 1 2 3');
?>
In the above example, ObjectA is not instantiated until needed by ObjectB. Then ObjectB can continually use it's creation as needed without reinstantiating it.
There are other ways, but I like this one :-)
cesoid at yahoo dot com
05-Oct-2005 07:01
is_a returns TRUE for instances of children of the class.
For example:
class Animal
{}
class Dog extends Animal
{}
$test = new Dog();
In this example is_a($test, "Animal") would evaluate to TRUE as well as is_a($test, "Dog").
This seemed intuitive to me, but did not seem to be documented.