instanceof
用于確定一個 PHP 變量是否屬于某一類
class 的實例:
示例 #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 并不發(fā)出任何錯誤信息而是返回
false
。PHP 7.3.0 之前不允許用于檢測常量。
示例 #6 用 instanceof
檢測其它變量
<?php
$a = 1;
$b = NULL;
$c = imagecreate(5, 5);
var_dump($a instanceof stdClass); // $a 是整數
var_dump($b instanceof stdClass); // $b 是 NULL
var_dump($c instanceof stdClass); // $c 是資源
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()。