instanceof
é usado para determinar se um variável do PHP
é uma objeto instânciado de uma certa
classe:
Exemplo #1 Usando instanceof com classes
<?php
class MyClass
{
}
class NotMyClass
{
}
$a = new MyClass;
var_dump($a instanceof MyClass);
var_dump($a instanceof NotMyClass);
?>
O exemplo acima irá imprimir:
bool(true) bool(false)
instanceof
pode também ser usado para determinar se uma variável
é um objeto instânciado de uma classe que herda de uma classe pai:
Exemplo #2 Usando instanceof com herança
<?php
class ParentClass
{
}
class MyClass extends ParentClass
{
}
$a = new MyClass;
var_dump($a instanceof MyClass);
var_dump($a instanceof ParentClass);
?>
O exemplo acima irá imprimir:
bool(true) bool(true)
Para verificar se um objeto não é uma instância de uma classe, o
operador lógico not
pode ser usado.
Exemplo #3 Usando instanceof para verificar se o objeto não é uma instância da classe
<?php
class MyClass
{
}
$a = new MyClass;
var_dump(!($a instanceof stdClass));
?>
O exemplo acima irá imprimir:
bool(true)
Por fim, instanceof
pode também ser usado para determinar se
uma variável é um objeto instânciado de uma classe que implementa uma
interface:
Exemplo #4 Usando instanceof para classe
<?php
interface MyInterface
{
}
class MyClass implements MyInterface
{
}
$a = new MyClass;
var_dump($a instanceof MyClass);
var_dump($a instanceof MyInterface);
?>
O exemplo acima irá imprimir:
bool(true) bool(true)
Embora instanceof
é usualmente usado com um nome de classe literal,
ele pode também ser usado com outro objeto ou uma variável string:
Exemplo #5 Usando instanceof com outras variáveis
<?php
interface MyInterface
{
}
class MyClass implements MyInterface
{
}
$a = new MyClass;
$b = new MyClass;
$c = 'MyClass';
$d = 'NotMyClass';
var_dump($a instanceof $b); // $b é umn objeto da classe MyClass
var_dump($a instanceof $c); // $c é uma string 'MyClass'
var_dump($a instanceof $d); // $d é uma string 'NotMyClass'
?>
O exemplo acima irá imprimir:
bool(true) bool(true) bool(false)
instanceof não lança erros se a variável testada não for um objeto, apenas retorna false. Constantes, entretanto, não são permitidas.
Exemplo #6 Utilizando instanceof
para testar outras variáveis
<?php
$a = 1;
$b = NULL;
$c = imagecreate(5, 5);
var_dump($a instanceof stdClass); // inteiro
var_dump($b instanceof stdClass); // NULL
var_dump($c instanceof stdClass); // resource
var_dump(FALSE instanceof stdClass);
?>
O exemplo acima irá imprimir:
bool(false) bool(false) bool(false) PHP Fatal error: instanceof expects an object instance, constant given
Há algumas detalhes para estar ciente. Antes do PHP 5.1.0,
instanceof
podia chamar __autoload()
quando o nome da classe não existe. Em adicional, se a classe não foi carregada,
um erro fatal poderia ocorrer. Isto pode funcionar usando a dynamic
class reference
, ou uma variável string contendo o nome da classe:
Exemplo #7 Evitando que o nome da classe seje verificado e fatal erros com instanceof no PHP 5.0
<?php
$d = 'NotMyClass';
var_dump($a instanceof $d); // não causa erro fatal
?>
O exemplo acima irá imprimir:
bool(false)
O operador instanceof
foi introduzido no PHP 5.
Antes disso is_a() era usado mas
is_a() tornou-se obsoleto pelo
instanceof
. A partir do PHP 5.3.0
is_a() não está mais obsoleta.
Veja também get_class() e is_a().