PHP - Операторы типов

instanceofиспользуется для определения того, является ли переменная PHP экземпляром объекта определенного класса :

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

<?php
class MyClass
{
}

class NotMyClass
{
}
$a = new MyClass;

var_dump($a instanceof MyClass);
var_dump($a instanceof NotMyClass);
?>

Приведенный выше пример выведет:

логический (правда)
логический (ложный)

instanceofтакже может использоваться для определения того, является ли переменная экземпляром объекта класса, который наследуется от родительского класса:

Пример #2 Использование instanceofс унаследованными классами

<?php
class ParentClass
{
}

class MyClass extends ParentClass
{
}

$a = new MyClass;

var_dump($a instanceof MyClass);
var_dump($a instanceof ParentClass);
?>

Приведенный выше пример выведет:

логический (правда)
логический (правда)

Чтобы проверить, не является ли объект экземпляром класса, можно использовать логический not оператор .

Пример #3 Использование instanceofдля проверки того, что объект не является экземпляром класса

<?php
class MyClass
{
}

$a = new MyClass;
var_dump(!($a instanceof stdClass));
?>

Приведенный выше пример выведет:

логический (правда)

Наконец, instanceofтакже можно использовать для определения того, является ли переменная экземпляром объекта класса, реализующего интерфейс :

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

<?php
interface MyInterface
{
}

class MyClass implements MyInterface
{
}

$a = new MyClass;

var_dump($a instanceof MyClass);
var_dump($a instanceof MyInterface);
?>

Приведенный выше пример выведет:

логический (правда)
логический (правда)

Хотя instanceofобычно используется с буквальным именем класса, его также можно использовать с другим объектом или строковой переменной:

Пример #5 Использование instanceofс другими переменными

<?php
interface MyInterface
{
}

class MyClass implements MyInterface
{
}

$a = new MyClass;
$b = new MyClass;
$c = 'MyClass';
$d = 'NotMyClass';

var_dump($a instanceof $b); // $b is an object of class MyClass
var_dump($a instanceof $c); // $c is a string 'MyClass'
var_dump($a instanceof $d); // $d is a string 'NotMyClass'
?>

Приведенный выше пример выведет:

логический (правда)
логический (правда)
логический (ложный)

instanceof не выдает никакой ошибки, если проверяемая переменная не является объектом, он просто возвращает false. Однако константы были запрещены до версии PHP 7.3.0.

Пример #6 Использование instanceofдля проверки других переменных

<?php
$a = 1;
$b = NULL;
$c = imagecreate(5, 5);
var_dump($a instanceof stdClass); // $a is an integer
var_dump($b instanceof stdClass); // $b is NULL
var_dump($c instanceof stdClass); // $c is a resource
var_dump(FALSE instanceof stdClass);
?>

Приведенный выше пример выведет:

логический (ложный)
логический (ложный)
логический (ложный)
Неустранимая ошибка PHP: instanceof ожидает экземпляр объекта, указанная константа

Начиная с PHP 7.3.0, константы разрешены слева от instanceofоператора.

Пример #7 Использование instanceofдля проверки констант

<?php
var_dump(FALSE instanceof stdClass);
?>

Вывод приведенного выше примера в PHP 7.3:

логический (ложный)

Начиная с PHP 8.0.0, instanceofтеперь можно использовать с произвольными выражениями. Выражение должно быть заключено в круглые скобки и давать строку .

Пример #8 Использование instanceofс произвольным выражением

<?php

class ClassA extends \stdClass {}
class ClassB extends \stdClass {}
class ClassC extends ClassB {}
class ClassD extends ClassA {}

function getSomeClass(): string
{
    return ClassA::class;
}

var_dump(new ClassA instanceof ('std' . 'Class'));
var_dump(new ClassB instanceof ('Class' . 'B'));
var_dump(new ClassC instanceof ('Class' . 'A'));
var_dump(new ClassD instanceof (getSomeClass()));
?>

Вывод приведенного выше примера в PHP 8:

логический (правда)
логический (правда)
логический (ложный)
логический (правда)

У instanceofоператора есть функциональный вариант с функцией is_a() .