عرض مصدر PHP/autoloading

<noinclude>{{DISPLAYTITLE:التحميل التلقائي للأصناف في PHP}}</noinclude>
يُنشئ أغلب المطوّرين الذي يكتبون تطبيقات كائنية التوجه ملف PHP واحد لكل صنف. وهنا تظهر مشكلة مزعجة للغاية، وهي الحاجة إلى كتابة قائمة طويلة بالأصناف التي يجب تضمينها للبدء بتنفيذ الشيفرة (قائمة لكل صنف).

لم يعد هذا الأمر ضروريًا في الإصدار الخامس من اللغة، إذ تسجّل الدالة <code>[[PHP/spl_autoload_register|spl_autoload_register()]]</code>‎‎ عددًا غير محدّدٍ من المحمّلات التلقائية لتتيح إمكانية التحميل التلقائي للأصناف والواجهات غير المعرّفة في ملف الشيفرة. يمنح تسجيلُ المحمّلات التلقائية اللغةَ فرصة أخيرة لتحميل الصنف أو الواجهة قبل أن تتوقف الشيفرة عن العمل وتطلق خطأً.

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

ملاحظة: قبل الإصدار 5.3 من اللغة، لم يكن بالإمكان التقاط الاستثناءات التي تطلقها الدالة <code>‎[[PHP/autoload|__autoload()]]‎</code> بواسطة كتلة <code>catch</code> وقد يتسبب الأمر في حدوث خطأ من نوع fatal. ولكن في الإصدار 5.3 وما بعده، أصبح هذا الأمر ممكنًا بشرط إطلاق استثناء المخصص، ثم يكون صنف الاستثناء المخصص متاحًا. يمكن استخدام الدالة <code>[[PHP/autoload|‎__autoload()]]</code>‎ تعاوديًا لتحميل صنف الاستثناء المخصص تلقائيًا.

ملاحظة: التحميل التلقائي غير متاحٍ عند استخدام PHP في نمط سطر الأوامر التفاعلي CLI.

ملاحظة: يمكن لاسم الصنف أن يتضمّن بعض المحارف الخطيرة مثل <code>‎../.</code>‎ إن استُخدم على سبيل المثال في الدالة <code>[[PHP/call_user_func|call_user_func()‎]]</code>؛ لذا ينصح بعدم استخدام مدخلات المستخدم في مثل هذه الدوال أو التحقّق على الأقل من المدخلات في الدالة ‎<code>[[PHP/autoload|__autoload()‎]]</code>.

المثال 1: مثال على التحميل التلقائي

تحاول الشيفرة التالية تحميل الصنفين <code>MyClass1</code> و <code>MyClass2</code> من الملفين <code>MyClass1.php</code> و <code>MyClass2.php</code> على التوالي.
<syntaxhighlight lang="php">

<?php
spl_autoload_register(function ($class_name) {
    include $class_name . '.php';
});

$obj  = new MyClass1();
$obj2 = new MyClass2(); 
?>
</syntaxhighlight>

المثال 2: مثال آخر على التحميل التلقائي

تحاول هذه الشيفرة تحميل الواجهة ITest.
<syntaxhighlight lang="php">

<?php

spl_autoload_register(function ($name) {
    var_dump($name);
});

class Foo implements ITest {
}

/*
string(5) "ITest"

Fatal error: Interface 'ITest' not found in ...
*/
?>
</syntaxhighlight>

المثال 3: التحميل التلقائي مع التحكم في الاستثناءات في الإصدار 5.3.0 وما بعده من اللغة

ترمي الشيفرة التالية استثناءً وتبيّن طريقة استخدام كتلة try/catch.
<syntaxhighlight lang="php">

<?php
spl_autoload_register(function ($name) {
    echo "Want to load $name.\n";
    throw new Exception("Unable to load $name.");
});

try {
    $obj = new NonLoadableClass();
} catch (Exception $e) {
    echo $e->getMessage(), "\n";
}
?>
</syntaxhighlight>

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

Want to load NonLoadableClass.
Unable to load NonLoadableClass.
</syntaxhighlight>

المثال 4: التحميل التلقائي مع معالجة الاستثناءات في الإصدار 5.3.0 وما بعده من اللغة مع وجود استثناء مخصّص

ترمي الشيفرة التالية استثناء مخصصًا عندما يكون الصنف غير قابلٍ للتحميل.
<syntaxhighlight lang="php">

<?php
spl_autoload_register(function ($name) {
    echo "Want to load $name.\n";
    throw new MissingException("Unable to load $name.");
});

try {
    $obj = new NonLoadableClass();
} catch (Exception $e) {
    echo $e->getMessage(), "\n";
}
?>
</syntaxhighlight>

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

Want to load NonLoadableClass.
Want to load MissingException.

Fatal error: Class 'MissingException' not found in testMissingException.php on line 4
</syntaxhighlight>
== انظر أيضًا ==
* الدالة <code>[[PHP/unserialize|unserialize()‎]]</code> : إعطاء قيمة بلغة PHP انطلاقًا من تمثيل مُخزَّن.
* الدالة <code>[[PHP/unserialize|unserialize_callback_func‎]]</code> : دالة استدعاء عند استنساخ صنف غير مُعرَّف خلال فك التسلسل.
* الدالة <code>[[PHP/spl autoload register|spl_autoload_register()‎]]</code> : تحميل الأصناف والواجهات تلقائيًا.
* الدالة <code>[[PHP/spl autoload register|spl_autoload()‎]]</code> : تحميل الأصناف والواجهات تلقائيًا.
* الدالة [[PHP/autoload|<code>‎__autoload()‎‎</code>]] : تحميل الأصناف والواجهات تلقائيًا.
== مصادر ==
* [http://php.net/manual/en/language.oop5.autoload.php صفحة Autoloading Classes في توثيق PHP الرسمي.]
[[تصنيف:PHP|{{SUBPAGENAME}}]]
[[تصنيف:PHP OOP|{{SUBPAGENAME}}]]