instanceof işleci, bir PHP değişkeninin belli bir sınıfın nesnel örneği olup olmadığını saptar:
Örnek 1 - instanceof ve sınıflar
<?php
class Sınıfım
{
}
class BaşkaSınıf
{
}
$a = new Sınıfım;
var_dump($a instanceof Sınıfım);
var_dump($a instanceof BaşkaSınıf);
?>Yukarıdaki örneğin çıktısı:
bool(true) bool(false)
instanceof ayrıca, bir değişkenin, bir ebeveyn sınıftan miras alınan bir sınıfın nesnel örneği olup olmadığını saptamak için de kullanılabilir:
Örnek 2 - Miras alınan sınıflar ve instanceof kullanımı
<?php
class EbeveynSınıf
{
}
class Sınıfım extends EbeveynSınıf
{
}
$a = new Sınıfım;
var_dump($a instanceof Sınıfım);
var_dump($a instanceof EbeveynSınıf);
?>Yukarıdaki örneğin çıktısı:
bool(true) bool(true)
Bir nesne bir sınıfın örneği değilse bunu sınamak için mantıksal değil işleci kullanılabilir.
Örnek 3 - Bir sınıfın örneği olmayan bir sınıfın instanceof ile sınanması
<?php
class Sınıfım
{
}
$a = new Sınıfım;
var_dump(!($a instanceof stdClass));
?>Yukarıdaki örneğin çıktısı:
bool(true)
Son olarak, instanceof işleci, bir değişkenin, bir arayüzü gerçekleyen bir sınıfın örneği olup olmadığını sınamak için kullanılabilir:
Örnek 4 - Arayüzler için instanceof kullanımı
<?php
interface Arayüzüm
{
}
class Sınıfım implements Arayüzüm
{
}
$a = new Sınıfım;
var_dump($a instanceof Sınıfım);
var_dump($a instanceof Arayüzüm);
?>Yukarıdaki örneğin çıktısı:
bool(true) bool(true)
instanceof işlecinin normal olarak bir sayıl sınıf ismi ile kullanılmasının yanında başka bir nesne veya bir dizge değişkeni ile de kullanılabilir:
Örnek 5 - Başka değişkenlerle instanceof kullanımı
<?php
interface Arayüzüm
{
}
class Sınıfım implements Arayüzüm
{
}
$a = new Sınıfım;
$b = new Sınıfım;
$c = 'Sınıfım';
$d = 'BaşkaSınıf';
var_dump($a instanceof $b); // $b, Sınıfım sınıfının bir nesnesidir
var_dump($a instanceof $c); // $c 'Sınıfım' dizgesini içerir
var_dump($a instanceof $d); // $d 'BaşkaSınıf' dizgesini içerir
?>Yukarıdaki örneğin çıktısı:
bool(true) bool(true) bool(false)
Sınanan değişken bir nesne değilse instanceof hata çıktılamaz, basitçe false döndürür. Sabitlere, her nasılsa, PHP 7.3.0 öncesinde izin verilmezdi.
Örnek 6 - Değişkenleri sınamak için instanceof kullanımı
<?php
$a = 1;
$b = NULL;
$c = imagecreate(5, 5);
var_dump($a instanceof stdClass); // $a bir tamsayıdır
var_dump($b instanceof stdClass); // $b NULL'dur
var_dump($c instanceof stdClass); // $c bir özkaynaktır
var_dump(FALSE instanceof stdClass);
?>Yukarıdaki örneğin çıktısı:
bool(false) bool(false) bool(false) PHP Fatal error: instanceof expects an object instance, constant given
PHP 7.3.0 ve sonrasında, instanceof işlecinin sol tarafında sabitlere izin verilmektedir.
Örnek 7 - Sabit kullanımını sınamak için instanceof kullanımı
<?php
var_dump(FALSE instanceof stdClass);
?>Yukarıdaki örneğin PHP 7.3 çıktısı:
bool(false)
PHP 8.0.0 ve sonrasında, instanceof keyfi ifadelerde kullanılabilmektedir. Bu ifadeler parantezlerle sarmalanmalı ve bir dizge üretmelidir.
Örnek 8 - Keyfi ifadelerde instanceof kullanımı
<?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()));
?>Yukarıdaki örneğin PHP 8 çıktısı:
bool(true) bool(true) bool(false) bool(true)
instanceof işleci yerine kullanılabilecek bir işlev de vardır: is_a()