Operatori di tipi

instanceof è utilizzato per determinare se una variabile PHP è un oggetto istanza di una certa classe:

Example #1 Utilizzo di instanceof con le classi

<?php
class MyClass
{
}

class NotMyClass
{
}
$a = new MyClass;

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

Il precedente esempio visualizzerà:

bool(true)
bool(false)

instanceof può essere usato anche per determinare se una variabile è un oggetto istanziato da una classe che eredita da una classe parente:

Example #2 Utilizzo di instanceof con le classi ereditate

<?php
class ParentClass
{
}

class MyClass extends ParentClass
{
}

$a = new MyClass;

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

Il precedente esempio visualizzerà:

bool(true)
bool(true)

Al fine di controllare se un oggetto non è un instanceof di una classe, si può usare l'operatore logico not .

Example #3 Utilizzo di instanceof per controllare se un oggetto non è un'instanceof di una classe

<?php
class MyClass
{
}

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

Il precedente esempio visualizzerà:

bool(true)

Infine, instanceof può essere usato anche per deretmnare se una variable è un oggetto istanziato da una classe che implementa una interfaccia:

Example #4 Utilizzo di instanceof con interfacce

<?php
interface MyInterface
{
}

class MyClass implements MyInterface
{
}

$a = new MyClass;

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

Il precedente esempio visualizzerà:

bool(true)
bool(true)

Anche se instanceof è normalmente usata con un nome di classe letterale, può essere usata con un altro oggetto o con una variabile stringa:

Example #5 Utilizzo di instanceof con altre variabili

<?php
interface MyInterface
{
}

class MyClass implements MyInterface
{
}

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

var_dump($a instanceof $b); // $b è un oggetto di classe MyClass
var_dump($a instanceof $c); // $c è la stringa 'MyClass'
var_dump($a instanceof $d); // $d è la stringa 'NotMyClass'
?>

Il precedente esempio visualizzerà:

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

instanceof non genera errori se la variabile che viene controllata non è un oggetto, ma ritorna semplicemente false. Le costanti non erano comunque ammesse prima di PHP 7.3.0.

Example #6 Utilizzo di instanceof per controllare altre variabili

<?php
$a = 1;
$b = NULL;
$c = imagecreate(5, 5);
var_dump($a instanceof stdClass); // $a è un integer
var_dump($b instanceof stdClass); // $b è NULL
var_dump($c instanceof stdClass); // $c è una risorsa
var_dump(FALSE instanceof stdClass);
?>

Il precedente esempio visualizzerà:

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

A partire da PHP 7.3.0, le costanti sono permesse sul lato sinistro dell'operatore instanceof.

Example #7 Utilizzo di instanceof per testare le costanti

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

Output of the above example in PHP 7.3:

bool(false)

A partire da PHP 8.0.0, instanceof ora può essere utilizzato con espressioni arbitrarie. L'espressione deve essere racchiusa tra parentesi e produrre una string.

Example #8 Utilizzo di instanceof con un'espressione arbitraria

<?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()));
?>

Output of the above example in PHP 8:

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

L'operatore instanceof ha una variante funzionale con la funzione is_a().

Operatori di tipi

Vedere anche: