PHP - Manual: is_a

2024-12-22

is_subclass_of »

« interface_exists

is_a

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

is_a — 如果对象属于该类或该类是此对象的父类则返回 true

说明

is_a(mixed $object, string $class_name, bool $allow_string = false): bool

如果 object 是该类或该类是此对象的父类。

参数

object: 类名或者实例对象。
class_name: 类名
allow_string: 如果本参数设置为 false，object 就不允许传入字符串类名。这也会在类不存在时，阻止调用自动加载器（autoloader）。

返回值

如果对象属于该类或该类是此对象的父类时返回 true，否则返回 false。

范例

示例 #1 is_a() 例子


<?php
// define a class
class WidgetFactory
{
  var $oink = 'moo';
}

// create a new object
$WF = new WidgetFactory();

if (is_a($WF, 'WidgetFactory')) {
  echo "yes, \$WF is still a WidgetFactory\n";
}
?>

示例 #2 在 PHP 5 中使用 instanceof 运算符


<?php
if ($WF instanceof WidgetFactory) {
    echo 'Yes, $WF is a WidgetFactory';
}
?>

参见

get_class() - 返回对象的类名
get_parent_class() - 返回对象或类的父类名
is_subclass_of() - 如果此对象是该类的子类，则返回 true

add a note

User Contributed Notes 6 notes

down

Ronald Locke ¶

5 years 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.

down

Aron Budinszky ¶

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

down

p dot scheit at zweipol dot net ¶

15 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

down

cesoid at yahoo dot com ¶

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

down

dkrupyanskiy[at]gmail ¶

4 years ago


Looks like the function signature given in description is wrong. Actually it can take a string  as a first parameter in the case if $allow_string is set to true. 

It took some time to find out how the last parameter should be used. Please consider the following example

<?php

class Foo{}

spl_autoload_register(
    function($classname){
        printf('autoload has been triggered for %s%s', $classname, PHP_EOL);
    }
);

var_dump(is_a('UndefinedClassName', Foo::class, true));

?>

down

eitan at mosenkis dot net ¶

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

add a note

官方地址：https://www.php.net/manual/en/function.is-a.php

有任何技术问题请点击这里网站运营推广招聘

IT PHP 编程语言 Linux 开发编程科技 Elasticsearch HTML/CSS/XML 网络数据库 JAVA 面试 NoSQL C/C++ Golang Git 算法操作系统正则表达式 Redis 互联网 MySql JavaScript 运维软件国际架构设计 Mac OS TCP/IP Excel Vim Windows Socket Oracle VR MongoDB Python 运营 MemCache 商业硬件电子娱乐设计 nginx 摄影游戏 WordPress HTTP 团建数码电器

php7 安装fileinfo扩展 preg_split — 通过一个正则表达式分隔字符串 php位值,解决 PHP 中 usort 在值相同时改变原始位置的问题 [PHP] inet_pton/inet_ntop IP地址转换函数 [鸟哥]PHP_INT_MIN 和 -9223372036854775808 PHP 8.1 ADORecordSet对象 adodb手册 opcache预加载 Composer的Packagist资源 array_multisort() 多字段排序 mysql面试题 PHPMailer设置utf8 PHPMailer字符集CharSet PHP json解析（json_decode）页面工具 [原创]诡异的php-fpm超时问题 php中几种注释规范纯php实现DES以及TripleDES加密算法 php扩展开发 PHP获取指定函数定义在哪个文件中及行号 PHP注释规范

略微加速

PHP官方手册 - 互联网笔记

is_a

说明

参数

返回值

范例

参见

User Contributed Notes 6 notes