عرض مصدر PHP/type operators

<noinclude>{{DISPLAYTITLE:عوامل الأنواع في PHP}}</noinclude>
تستخدم <code>instanceof</code> لتحديد ما إذا كان المتغير كائنًا مهيّئًا من صنف معين:

المثال 1: استخدام <code>instanceof</code> مع الأصناف
<syntaxhighlight lang="php">

<?php
class MyClass
{
}

class NotMyClass
{
}
$a = new MyClass;

var_dump($a instanceof MyClass);
var_dump($a instanceof NotMyClass);
?></syntaxhighlight>

يعطي المثال السابق المخرجات التالية:
<syntaxhighlight lang="php">

bool(true)
bool(false)
</syntaxhighlight>

يمكن استخدام <code>instanceof</code> كذلك لتحديد ما إذا كان المتغير كائنًا مهيّئًا من صنف موروث من صنف آخر:

المثال 2: استخدام <code>instanceof</code> مع الأصناف الموروثة
<syntaxhighlight lang="php">

<?php
class ParentClass
{
}

class MyClass extends ParentClass
{
}

$a = new MyClass;

var_dump($a instanceof MyClass);
var_dump($a instanceof ParentClass);
?>
</syntaxhighlight>

يعطي المثال السابق المخرجات التالية:
<syntaxhighlight lang="php">

bool(true)
bool(true)
</syntaxhighlight>

يمكن استخدام عامل النفي للتأكد من أن الكائن ليس مهيّئًا من صنف ما:

المثال 3: استخدام <code>instanceof</code> للتأكد من كون الكائن مهيّئًا من صنف أو لا
<syntaxhighlight lang="php">

<?php
class MyClass
{
}

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

تعطي الشيفرة السابقة المخرجات التالية:
<syntaxhighlight lang="php">

bool(true)
</syntaxhighlight>

وأخيرًا، يمكن استخدام <code>instanceof</code> أيضًا لتحديد ما إذا كان المتغير كائنًا مهيّئًا من صنف يستخدم واجهة معينة:

المثال 4: استخدام <code>instanceof</code> مع الأصناف
<syntaxhighlight lang="php">

<?php
interface MyInterface
{
}

class MyClass implements MyInterface
{
}

$a = new MyClass;

var_dump($a instanceof MyClass);
var_dump($a instanceof MyInterface);
?>
</syntaxhighlight>

تعطي الشيفرة السابقة المخرجات التالية:
<syntaxhighlight lang="php">

bool(true)
bool(true)
</syntaxhighlight>

عادة ما تستخدم <code>instanceof</code> مع أسماء الأصناف، ولكن يمكن استخدامها مع الكائنات الأخرى أو مع السلاسل النصية:

المثال 5: استخدام <code>instanceof</code> مع متغيرات أخرى
<syntaxhighlight lang="php">

<?php
interface MyInterface
{
}

class MyClass implements MyInterface
{
}

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

var_dump($a instanceof $b); // $b is an object of class MyClass
var_dump($a instanceof $c); // $c is a string 'MyClass'
var_dump($a instanceof $d); // $d is a string 'NotMyClass'
?>
</syntaxhighlight>

يعطي المثال السابق المخرجات التالية:
<syntaxhighlight lang="php">

bool(true)
bool(true)
bool(false)
</syntaxhighlight>

لا ترمي <code>instanceof</code> أي خطأ في حال لم يكن المتغير المفحوص كائنًا، بل تعيد <code>FALSE</code> فقط. ولكن لا يمكن استخدام الثوابت.

المثال 6: استخدام <code>instanceof</code> لاختبار المتغيرات الأخرى
<syntaxhighlight lang="php">

<?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);
?>
</syntaxhighlight>

تعطي الشيفرة السابقة المخرجات التالية:
<syntaxhighlight lang="php">

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

هناك بعض الأمور التي يجب الانتباه إليها عند استخدام <code>instanceof</code>. قبل الإصدار 5.1.0 من PHP تستدعي <code>instanceof</code> الدالة <code>[[PHP/autoload|‎__autoload()‎]]</code> إن كان اسم الصنف غير موجودًا. إضافة إلى ذلك، يحدث خطأ من النوع fatal error في حال عدم تحميل الصنف. يمكن تجاوز هذا الأمر باستخدام مرجع الصنف الديناميكي، أو سلسلة نصية تتضمن اسم الصنف:

المثال 7: تجنب البحث عن اسم الصنف والأخطاء المميتة عند استخدام <code>instanceof</code> في PHP 5.0
<syntaxhighlight lang="php">

<?php
$d = 'NotMyClass';
var_dump($a instanceof $d);
// لن يحدث خطأ مميت هنا
?>
</syntaxhighlight>

تعطي الشيفرة السابقة المخرجات التالية:
<syntaxhighlight lang="php">

bool(false)
</syntaxhighlight>

ظهر العامل <code>instanceof</code> في الإصدار 5 من PHP، وقبل هذا الإصدار استُخدمت الدالة <code>[[PHP/is_a|is_a()]]</code>‎ ولكنّها الآن أصبحت مهملة منذ ذلك الحين. لم تعد الدالة <code>[[PHP/is_a|is_a()‎]]</code> مهملة منذ الإصدار 5.3.0 من PHP.

راجع أيضًا الدوال <code>[[PHP/get_class|get_class()‎]]</code> و <code>[[PHP/is_a|is_a()]]</code>‎.

== مصادر ==
* [http://php.net/manual/en/language.operators.type.php صفحة Type Operators في توثيق PHP الرسمي.]
[[تصنيف:PHP|{{SUBPAGENAME}}]]
[[تصنيف:PHP Operators|{{SUBPAGENAME}}]]