الدالة get_class()‎‎ في PHP

(PHP 4, PHP 5, PHP 7)

تُعيد الدالة  get_class()‎‎‎‎‎‎‎‎ اسم الصنف لكائن object.

الوصف

string get_class ([ object $object ] )

تحصل الدالة get_class()‎‎‎‎‎‎‎‎ على اسم الصنف للكائن المُعطى object.

المعاملات

object

اسم الكائن المُختبر. من الممكن أن يُحذف هذا المعامل عندما يتم استخدام الدالة get_class()‎  داخل صنف ما.

ملاحظة: لم يعُد التمرير الصريح للقيمة NULL كقيمة للمعامل object مسموحًا بدءًا من الإصدار PHP 7.2.0. ولكن لا يزال المعامل object اختياريًا، وسيعمل استدعاء الدالة get_class()‎  بدون المعامل object من داخل صنف ما، ولكن سيولد  تمرير NULL التحذير E_WARNING.

القيم المعادة

تُعيد الدالة get_class()‎‎‎‎‎‎‎‎ اسم الصنف الذي يكون الكائن object نسخة منه. وستعيد الدالة القيمة FALSE  إذا كان object ليس بكائن.

في حال كان المعامل object  مُلغى عند استدعاء الدالة  داخل صنف، ستعيد الدالة اسم هذا الصنف.

و في حال كان المعامل object هو نسخة لصنف موجود في مجال أسماء، ستُعيد الدالة الاسم المُكافئ لاسم الصنف من مجال الأسماء.

الأخطاء والاستثناءات

عند استدعاء الدالة get_class()‎ بمعامل ليس بكائن ،سيظهر مستوى الخطأ E_WARNING.

سجل التغييرات

الإصدار	الوصف
7.2.0	إزالة NULL كقيمة افتراضية للمعامل object، و لم يعد بعد ذلك قيمة متاحة.
5.3.0	أصبحت NULL  قيمة افتراضية للمعامل object، أي أصبح تمرير القيمة NULL للمعامل object يملك نفس نتيجة عدم تمرير أية قيمة.

أمثلة

المثال 1: مثال عن استخدام الدالة get_class()‎

<?php
class foo {
    function name()
    {
        echo "My name is " , get_class($this) , "\n";
    }
}
//إنشاء كائن‏
$bar = new foo();
//استدعاء خارجي‏
echo "Its name is " , get_class($bar) , "\n";
//استدعاء داخلي‏
$bar->name();
?>

سينتج المثال السابق الناتج الآتي:

Its name is foo
My name is foo

المثال 2: مثال عن استخدام الدالةget_class()‎ في صنف أعلى (superclass)

<?php
abstract class bar {
    public function __construct()
    {
        var_dump(get_class($this));
        var_dump(get_class());
    }
}
class foo extends bar {
}
new foo;
?>

سينتج المثال السابق الناتج الآتي:

string(3) "foo"
string(3) "bar"

المثال 3: مثال عن استخدام الدالةget_class()‎ مع أصناف  ذات مجال أسماء

<?php
namespace Foo\Bar;
class Baz {
    public function __construct()
    {
    }
}

$baz = new \Foo\Bar\Baz;
var_dump(get_class($baz));
?>

سينتج المثال السابق الناتج الآتي:

string(11) "Foo\Bar\Baz"

انظر أيضًا

• الدالة get_called_class()‎‎‎‎‎‎: إعادة اسم صنف الروابط الساكنة المتأخرة (Late Static Binding).
• الدالة get_parent_class()‎: الحصول على اسم الصنف الأب لكائن أو لصنف.
• الدالة gettype()‎‎‎‎‎‎: الحصول على نوع المتغير.
• الدالة is_subclass_of()‎‎‎‎‎‎‎: التحقق فيما إذا كان يملك الكائن صنفًا ما كواحد من الأصناف الآباء له.

مصادر

• صفحة الدالة get_class‎‎‎ في توثيق PHP الرسمي.