العودة إلى الدورة

تضمين الملفات (Including Files): include مقابل require

PHP: الدورة التدريبية المكثفة الكاملة من الصفر إلى الاحتراف

10. تضمين الملفات: include مقابل require

مع نمو التطبيقات، يجب علينا تنظيم الكود في ملفات منفصلة (مثل الرؤوس والتذييلات والتكوينات). توفر PHP أربع طرق لتضمين الملفات الخارجية.

لماذا نضمّن الملفات؟

  • الوحدات (Modularity): فصل الاهتمامات (مثل اتصال قاعدة البيانات في config.php).
  • قابلية إعادة الاستخدام (Reusability): استخدام نفس الرأس/التذييل عبر العديد من الصفحات.
  • سهولة الصيانة (Maintainability): أسهل في تحديث ملف واحد بدلاً من ملفات متعددة.

1. include

تقرأ عبارة include الملف المحدد وتنفذ الكود بداخله. إذا لم يتم العثور على الملف، فإنها تُصدر تحذيرًا (Warning) ويستمر السكربت في العمل.

php

مرحبًا بك في المحتوى الرئيسي!"; include 'footer.php'; ?>

2. require

عبارة require مطابقة لـ include، باستثناء حالة عدم العثور على الملف. إذا كان الملف مفقودًا، فإنها تُصدر خطأ فادحًا (Fatal Error) وتوقف تنفيذ السكربت فورًا.

php

قاعدة عامة: استخدم require للملفات الأساسية (مثل التكوين أو تعريفات الدوال) واستخدم include للأجزاء غير الأساسية (مثل القوالب أو المكونات الاختيارية).

3. include_once و require_once

تضمن هذه المتغيرات أن يتم تضمين الملف وتنفيذه مرة واحدة فقط، حتى إذا تم استدعاء العبارة عدة مرات. هذا يمنع أخطاء إعادة تعريف الدوال وتعارض المتغيرات.

php