عرض مصدر PHP/is subclass of

<noinclude>{{DISPLAYTITLE:الدالة <code>is_subclass_of()‎</code>‎ في PHP}}</noinclude>
(PHP 4 >= 4.2.0, PHP 5, PHP 7)

تتحقق الدالة <code>is_subclass_of()</code>‎‎‎‎‎‎‎ فيما إذا كان يملك الكائن صنفًا ما كواحد من الأصناف الآباء له أو ينفذه.

== الوصف ==
<syntaxhighlight lang="php">
bool is_subclass_of ( mixed $object , string $class_name [, bool $allow_string = TRUE ] )
</syntaxhighlight>تتحقق الدالة <code>is_subclass_of()</code>‎‎‎‎‎‎‎  فيما إذا كان الصنف <code>class_name</code> هو واحد من الأصناف الآباء للكائن <code>object</code>.

== المعاملات ==

=== <code>object</code> ===
اسم الصنف أو نسخة الكائن. لن يولَّد خطأ إذا لم يكن الصنف موجودًا.

=== <code>class_name</code> ===
اسم الصنف.

=== <code>allow_string</code> ===
إذا ضُبِطَت قيمة هذا المعامل إلى القيمة <code>FALSE</code>، فلا يُسمح عندئذٍ باستخدام اسم صنف على شكل سلسلة نصية كقيمة للمعامل <code>object</code>. يمنع هذا أيضًا استدعاء <code>autoloader</code> إذا لم يكن الصنف موجودًا.

== القيم المعادة ==
تُعيد الدالة <code>is_subclass_of()</code>‎‎‎‎‎‎‎ القيمة <code>TRUE</code>  إذا كان الكائن <code>object</code> ينتمي إلى صنف هو صنف فرعي من الصنف <code>class_name</code>،  وإلاّ فإنها تُعيد القيمة <code>FALSE</code>.

== سجل التغييرات ==
{| class="wikitable"
!الإصدار
!الوصف
|-
|5.3.9
|أُضيف المعامل <code>allow_string</code>.
|-
|5.3.7
|أُضيف دعم إلى <code>class_name</code> ليعمل مع الواجهات.
|-
|5.0.3
|يمكنك تحديد المعامل <code>object</code> بسلسلة نصية (اسم الصنف).
|}

== أمثلة ==
المثال 1: مثال عن استخدام الدالة <code>is_subclass_of()‎</code><syntaxhighlight lang="php">
<?php
// ‏تعريف صنف
class WidgetFactory
{
  var $oink = 'moo';
}

// تعريف صنف ابن
class WidgetFactory_Child extends WidgetFactory
{
  var $oink = 'oink';
}

// تعريف كائن جديد‏
$WF = new WidgetFactory();
$WFC = new WidgetFactory_Child();

if (is_subclass_of($WFC, 'WidgetFactory')) {
  echo "yes, \$WFC is a subclass of WidgetFactory\n";
} else {
  echo "no, \$WFC is not a subclass of WidgetFactory\n";
}


if (is_subclass_of($WF, 'WidgetFactory')) {
  echo "yes, \$WF is a subclass of WidgetFactory\n";
} else {
  echo "no, \$WF is not a subclass of WidgetFactory\n";
}


// PHP 5.0.3قابل للاستخدام فقط منذ الإصدار ‏
if (is_subclass_of('WidgetFactory_Child', 'WidgetFactory')) {
  echo "yes, WidgetFactory_Child is a subclass of WidgetFactory\n";
} else {
  echo "no, WidgetFactory_Child is not a subclass of WidgetFactory\n";
}
?>
</syntaxhighlight>سينتج المثال السابق الناتج الآتي:<syntaxhighlight lang="text">
yes, $WFC is a subclass of WidgetFactory
no, $WF is not a subclass of WidgetFactory
yes, WidgetFactory_Child is a subclass of WidgetFactory
</syntaxhighlight>المثال 2: مثال عن استخدام الدالة <code>is_subclass_of()‎</code> مع واجهة<syntaxhighlight lang="php">
<?php
// ‏تعريف الواجهة
interface MyInterface
{
  public function MyFunction();
}

// تعريف تنفيذ الصنف للواجهة‏
class MyClass implements MyInterface
{
  public function MyFunction()
  {
    return "MyClass Implements MyInterface!";
  }
}

// نسخ الكائن‏
$my_object = new MyClass;

// يعمل منذ الاصدار 5.3.7‏

// اختبار استخدام نسخة الكائن للصنف‏
if (is_subclass_of($my_object, 'MyInterface')) {
  echo "Yes, \$my_object is a subclass of MyInterface\n";
} else {
  echo "No, \$my_object is not a subclass of MyInterface\n";
}

// اختبار استخدام السلسلة النصية لاسم الصنف‏
if (is_subclass_of('MyClass', 'MyInterface')) {
  echo "Yes, MyClass is a subclass of MyInterface\n";
} else {
  echo "No, MyClass is not a subclass of MyInterface\n";
}
?>
</syntaxhighlight>سينتج المثال السابق الناتج الآتي:<syntaxhighlight lang="text">
Yes, $my_object is a subclass of MyInterface
Yes, MyClass is a subclass of MyInterface
</syntaxhighlight>

== ملاحظات ==

ملاحظة: عند استخدام هذه الدالة ستُستخدَم أيّة تحميلات تلقائية <code>autoloaders</code> مُسجلة إذا لم يكن الصنف مُعرَّفًا من قبل.

== انظر أيضًا ==
* الدالة <code>[[PHP/get class|get_class()‎‎‎‎]]</code>: إعادة اسم الصنف لكائن.
* الدالة <code>[[PHP/get parent class|get_parent_class()]]</code>‎‎‎‎‎‎: الحصول على اسم الصنف الأب لكائن أو لصنف.
* الدالة <code>[[PHP/is a|is_a()]]</code>‎‎‎‎‎: التحقق فيما إذا كان الكائن من صنفٍ ما أو يملك ذاك الصنف كواحد من الأصناف الآباء له.
* الدالة <code>[[PHP/class parents|class_parents()‎‎‎‎‎‎]]</code>: إعادة الأصناف الآباء للصنف المُعطى.

== مصادر ==
* [http://php.net/manual/en/function.is-subclass-of.php صفحة الدالة is_subclass_of‎‎‎ في توثيق PHP الرسمي.]
[[تصنيف:PHP]]
[[تصنيف:PHP Function]]
[[تصنيف:PHP OOP]]
[[تصنيف:PHP Object Handling]]