(PHP 4 >= 4.2.0, PHP 5, PHP 7, PHP 8)
is_a — Проверяет, принадлежит ли объект типу или подтипу
Функция определяет, принадлежит ли объект или класс 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
// Определяем класс
class WidgetFactory
{
var $oink = 'moo';
}
// Создаём новый объект
$WF = new WidgetFactory();
if ($WF instanceof WidgetFactory) {
echo 'Да, тип объекта $WF принадлежит типу WidgetFactory';
}
?>
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.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...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 trueis_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.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));
?>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.