لتوصيل ملف إضافي بنص PHP ، استخدم الوظيفة الخاصة include. بعد توصيل مستند خارجي ، تتاح للمبرمج الفرصة لاستخدام الكود المكتوب أو محتوى آخر في التطبيق الحالي.
تشمل الوظيفة
يحتوي التضمين على بناء الجملة التالي:
تضمين "اسم الملف" ؛
الاسم هو مسار نسبي أو مطلق بامتداد المستند المضمن. إذا لم يتم تحديد موقع ، فإن PHP ستتحقق تلقائيًا من محتويات التكوين php.ini ، والذي يحدد include_path - دليل حيث يمكن وضع مكتبات إضافية. إذا كان التوجيه فارغًا أو لم يتم العثور على الملف المطلوب في المسار المحدد فيه ، فسيتم تجاهل تعبير التضمين.
بمجرد التمكين ، يمكنك استخدام المحتوى الذي تريده في البرنامج النصي ، وتعيين المتغيرات ، واستخدام التركيبات المعلنة ، وما إلى ذلك. على سبيل المثال ، هناك ملفان 1.php و 2.php. يبدو محتوى 1.php كما يلي:
<؟ php
$ أولا = "متغير من الملف الأول"؛
$ ثانيًا = "القيمة المستوردة" ؛
?>
لتضمين المتغيرات أعلاه في 2.php ، يمكنك إجراء العملية التالية:
<؟ php
تشمل "1.php" ؛
صدى $ أولا؛
ظهور $ = "$ ثانيًا" ؛
صدى $ تظهر؛ ؟>
في هذا البرنامج النصي للملف الثاني ، يتضمن الأمر include محتويات المستند الأول ، وبعد ذلك تُستخدم المتغيرات المُعلنة في 1.php لعرض القيم الضرورية على الشاشة.
يمكن استخدام التضمين في بداية الملف وداخل الوظيفة المعلنة في أي جزء من المستند. من غير المرغوب فيه استخدام الوظيفة لتوصيل الملفات الموجودة على خادم بعيد. إذا كنت ترغب في تنفيذ هذه الميزة ، فستحتاج إلى تمكين خيار allow_url_fopen في ملف php.ini على الخادم المحلي أو البعيد.
يتطلب
الوظيفة المطلوبة مشابهة للتضمين. الأوامر لا تختلف في بناء الجملة وتكنولوجيا التنفيذ. الاختلاف الوحيد هو أنه إذا كان الملف المحدد مفقودًا ، فسيتطلب إنهاء البرنامج النصي ، بينما يستمر التضمين في تنفيذ البرنامج النصي ويعرض تحذير E_WARNING المقابل ، والذي يمكن منعه باستخدام الرمز الخاص @. فمثلا:
<؟ php
تتطلب "1q.php" ؛
صدى "توقف البرنامج النصي عن العمل" ؛ ؟>
في هذا المثال ، تم تحديد المسار إلى المستند غير الموجود 1q.php. إذا كان الملف مفقودًا ، فلن يقوم البرنامج النصي بتنفيذ الأمر echo ، وستعرض شاشة المستخدم إما ورقة فارغة أو رسالة خطأ (حسب إعدادات php.ini). إذا أدخلت رمزًا مشابهًا باستخدام ما يلي:
<؟ php
تشمل "1q.php" ؛
صدى "سكريبت يستمر" ؛ ؟>
سيتم تنفيذ أمر echo وسيظهر النص المقابل على الشاشة.
