في PHP، يمكنك إدراج محتويات الملف في ملف PHP قبل أن يتم تنفيذه بواسطة الخادم.
يتم استخدام عبارات التضمين والطلب لإدراج تعليمات برمجية مفيدة مكتوبة في ملفات أخرى في تدفق التنفيذ.
include و require متطابقان باستثناء كيفية التعامل مع الأخطاء:
يتطلب إنشاء خطأ فادح (E_COMPILE_ERROR)، وبعد ذلك يتوقف البرنامج النصي عن التنفيذ.
يتضمن إنشاء تحذير (E_WARNING) ويستمر البرنامج النصي في التنفيذ بعد حدوث الخطأ.
لذلك، إذا كنت ترغب في متابعة التنفيذ وإخراج النتائج للمستخدم حتى لو كان الملف المضمن مفقودًا، فاستخدم التضمين. بخلاف ذلك، في أطر العمل، أو CMS، أو برمجة تطبيقات PHP المعقدة، استخدم دائمًا require للإشارة إلى الملفات الرئيسية في تدفق التنفيذ. ويساعد ذلك على تحسين أمان التطبيق وسلامته في حالة فقدان ملف مهم عن طريق الخطأ.
يؤدي تضمين الملفات إلى توفير الكثير من العمل. وهذا يعني أنه يمكنك إنشاء ملفات رأس أو تذييل أو قائمة قياسية لجميع صفحات الويب. بعد ذلك، عندما يحتاج الرأس إلى التحديث، يمكنك ببساطة تحديث ملف تضمين الرأس.
تضمين "اسم الملف"؛ أو طلب "اسم الملف"؛
لنفترض أن لديك ملف رأس قياسي يسمى "header.php". للإشارة إلى ملف الرأس هذا في الصفحة، يرجى استخدام include/require:
<html><head><meta charset="utf-8"><title>البرنامج التعليمي للمبرمج (codercto.com)</title></head><body><?php include 'header.php' ?> < h1>مرحبًا بك في صفحتي الرئيسية!</h1><p>بعض النصوص. </p></body></html>
لنفترض أن لدينا ملف قائمة قياسيًا يُستخدم في جميع الصفحات.
"القائمة.php":
echo '<a href="/">الصفحة الرئيسية</a><a href="/html">برنامج HTML التعليمي</a><a href="/php">برنامج PHP التعليمي</a>';
يجب أن تشير جميع الصفحات الموجودة في موقع الويب إلى ملف القائمة هذا. إليك كيفية القيام بذلك:
<html><head><meta charset="utf-8"><title>البرنامج التعليمي للمبرمج (codercto.com)</title></head><body><div><?php include 'menu.php' ; ?></div><h1>مرحبًا بك في صفحتي الرئيسية!</h1><p>بعض النصوص. </p></body></html>
لنفترض أن لدينا ملف تضمين ("vars.php") يعرّف المتغيرات:
<?php$color='red';$car='BMW';?>
هذه المتغيرات متوفرة في ملف الاستدعاء:
<html><head><meta charset="utf-8"><title>البرنامج التعليمي للمبرمج (codercto.com)</title></head><body><h1>مرحبًا بك في صفحتي الرئيسية!</h1> h1 ><?php include 'vars.php';echo "لدي سيارة $color $"; // لدي سيارة BMW حمراء?></body></html>