CascadiaPHP 2024

is_a

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

is_aПроверяет, принадлежит ли объект к типу или подтипу

Описание

is_a(mixed $object_or_class, string $class, bool $allow_string = false): bool

Функция определяет, принадлежит ли объект или класс object_or_class непосредственно к типу объекта class, или тип объекта class — супертип объекта или класса, который проверяют.

Список параметров

object_or_class

Имя класса или экземпляр объекта.

class

Имя класса или интерфейса.

allow_string

Если для параметра установлено значение false, то функция определит принадлежность типа объекта, который проверяют, к типу или подтипу класса, только если в параметр object_or_class передадут экземпляр объекта, а не имя класса. Это также предотвратит вызов автозагрузчика, если класс не найден.

Возвращаемые значения

Функция возвращает true, если объект object_or_class принадлежит к типу объекта class, или тип объекта class — супертип объекта, который проверяют, иначе false.

Примеры

Пример #1 Пример использования функции is_a()

<?php

// Объявляем класс
class WidgetFactory
{
var
$oink = 'moo';
}

// Создаём новый объект
$WF = new WidgetFactory();

if (
is_a($WF, 'WidgetFactory')) {
echo
"Да, \$WF всё ещё WidgetFactory\n";
}

?>

Пример #2 Использование оператора instanceof

<?php

if ($WF instanceof WidgetFactory) {
echo
'Да, $WF — WidgetFactory';
}

?>

Смотрите также

  • get_class() - Возвращает имя класса, которому принадлежит объект
  • get_parent_class() - Получает имя родительского класса для объекта или класса
  • is_subclass_of() - Проверяет, принадлежит ли объект к потомкам класса, или реализует ли объект или родители объекта интерфейс

add a note

User Contributed Notes 7 notes

up
64
Ronald Locke
7 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.
up
34
Aron Budinszky
12 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
17
p dot scheit at zweipol dot net
17 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
3
SlimDeluxe
1 year ago
For anyone wondering, this does not work with traits :(
up
10
cesoid at yahoo dot com
18 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
3
eitan at mosenkis dot net
12 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
1
dkrupyanskiy[at]gmail
6 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));

?>
To Top