Forum PHP 2017

is_a

(PHP 4 >= 4.2.0, PHP 5, PHP 7)

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 add a note

User Contributed Notes 6 notes

up
23
Aron Budinszky
5 years ago
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...
up
12
p dot scheit at zweipol dot net
10 years ago
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
up
6
Ronald Locke
8 months ago
Please note that you have to fully qualify the class name in the second parameter.

A use statement will not resolve namespace dependencies in that is_a() function.

<?php
namespace foo\bar;

class
A {};
class
B extends A {};
?>

<?php
namespace har\var;

use
foo\bar\A;
$foo = new foo\bar\B();

is_a($foo, 'A'); // returns false;
is_a($foo, 'foo\bar\A'); // returns true;
?>

Just adding that note here because all examples are without namespaces.
up
4
cesoid at yahoo dot com
11 years ago
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.
up
2
eitan at mosenkis dot net
5 years ago
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.
up
-6
portugal {at} jawira {dot} com
2 years ago
I just want to point out that you can replace "is_a()" function with the "instanceof" operator, BUT you must use a variable to pass the class name string.

This will work:
<?php
$object
= new \stdClass();
$class_name = '\stdClass';

var_dump(is_a($object, $class_name));     // bool(true)
var_dump(is_a($object, '\stdClass'));     // bool(true)
var_dump($object instanceof $class_name); // bool(true)
?>

While this don't:
<?php
$object
= new \stdClass();
var_dump($object instanceof '\stdClass'); // Parse error: syntax error, unexpected ''\stdClass'' (T_CONSTANT_ENCAPSED_STRING)
?>
To Top