На странице произошла ошибка #S51. Свяжитесь с вебмастером. PHP 5.6 и PHP 7 на русском: Функция is_a() - Проверяет, принадлежит ли объект к данному классу или содержит данный класс в числе своих предков

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 Использование оператора instanceof в PHP 5

<?php
if ($WF instanceof WidgetFactory) {
    echo 
'Да, $WF - WidgetFactory';
}
?>

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

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

Коментарии

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.
2005-10-05 22:01:04
http://php5.kiev.ua/manual/ru/function.is-a.html
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 
() {
    print 
"A";
  }
}

$testImpl = new TestImplementor();

var_dump(is_a($testImpl,'test'));
?>

will return true
2007-01-16 03:44:48
http://php5.kiev.ua/manual/ru/function.is-a.html
Автор:
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...
2011-09-07 07:21:55
http://php5.kiev.ua/manual/ru/function.is-a.html
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.
2012-01-12 15:09:26
http://php5.kiev.ua/manual/ru/function.is-a.html
Автор:
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 
{};
class 
extends {};
?>

<?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.
2016-09-30 17:19:11
http://php5.kiev.ua/manual/ru/function.is-a.html
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'$classnamePHP_EOL);
    }
);

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

?>
2018-01-10 23:36:40
http://php5.kiev.ua/manual/ru/function.is-a.html
Автор:
For anyone wondering, this does not work with traits :(
2022-11-14 17:52:09
http://php5.kiev.ua/manual/ru/function.is-a.html

    Поддержать сайт на родительском проекте КГБ