Оператор проверки типа

Оператор instanceof определяет, содержит ли PHP-переменная экземпляр объекта конкретного класса.

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

<?php

class MyClass {}

class NotMyClass {}

$a = new MyClass();

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

?>

Результат выполнения приведённого примера: 

bool(true)
bool(false)

Оператор instanceof также определяет, принадлежит ли объект, который хранит переменная, классу-наследнику:

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

<?php

class ParentClass {}

class MyClass extends ParentClass {}

$a = new MyClass();

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

?>

Результат выполнения приведённого примера: 

bool(true)
bool(true)

Для проверки непринадлежности объекта классу, указывают логический оператор not .

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

<?php

class MyClass {}

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

?>

Результат выполнения приведённого примера: 

bool(true)

Наконец, оператор instanceof также проверяет, реализует ли объект интерфейс:

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

<?php

interface MyInterface {}

class MyClass implements MyInterface {}

$a = new MyClass();

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

?>

Результат выполнения приведённого примера: 

bool(true)
bool(true)

Хотя оператор 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 — объект класса MyClass
var_dump($a instanceof $c); // Переменная $c — строка 'MyClass'
var_dump($a instanceof $d); // Переменная $d — строка 'NotMyClass'

?>

Результат выполнения приведённого примера: 

bool(true)
bool(true)
bool(false)

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

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

<?php

$a = 1;
$b = NULL;
$c = fopen('/tmp/', 'r');

var_dump($a instanceof stdClass); // Переменная $a — целое типа integer
var_dump($b instanceof stdClass); // Переменная $b — NULL
var_dump($c instanceof stdClass); // Переменная $c — значение типа resource
var_dump(FALSE instanceof stdClass);

?>

Результат выполнения приведённого примера: 

bool(false)
bool(false)
bool(false)
PHP Fatal error:  instanceof expects an object instance, constant given

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

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

<?php

var_dump(FALSE instanceof stdClass);

?>

Результат выполнения приведённого примера в PHP 7.3: 

bool(false)

Начиная с PHP 8.0.0 оператор instanceof разрешили использовать с произвольными выражениями. Требования к выражению: записывается в круглых скобках и возвращает строку (string).

Пример #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: 

bool(true)
bool(true)
bool(false)
bool(true)

Оператор instanceof аналогичен функции is_a().

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