require, include, require_once, include_once في PHP: شرح كامل مع أمثلة

require, include, require_once, include_once في PHP: أيهما تختار ولماذا هو مهم؟

هل سبق لك أن تساءلت: "ما الفرق بين require و include في PHP؟ ولماذا تم اختراع النسخ _once؟" إذا كان الأمر كذلك، فأنت لست وحدك. هذا السؤال من بين الأكثر شيوعًا على Stack Overflow (آلاف المشاهدات وعشرات الأصوات). وهذا ليس من قبيل الصدفة.

كل يوم، يستخدم آلاف مطوري PHP — من المبتدئين إلى المحترفين — هذه الدوال. لكن الكثيرين يستخدمونها بشكل تلقائي دون التفكير في العواقب. وهذا خطأ. فالاختيار الخاطئ قد يؤدي إلى أخطاء فادحة، أو تكرار في الكود، أو ما هو أسوأ، إلى أخطاء غير واضحة تظهر فقط على الخادم المباشر.

اليوم، سنحسم الأمر مرة واحدة وإلى الأبد. سنشرح الفروقات بين require، include، require_once و include_once. ستتعلم ليس فقط النظري، بل وسترى أمثلة حية يمكنك تشغيلها فورًا. هيا بنا!

1. الأساسيات: لماذا نضمّن الملفات؟

قبل الحديث عن الاختلافات، دعنا نتذكر لماذا نفعل ذلك. في المشاريع الحقيقية، لا يُكتب كود PHP في ملف واحد ضخم. سيكون ذلك كابوسًا للصيانة. بدلاً من ذلك، يتم تقسيم الكود إلى وحدات:

\n
• الإعدادات — config.php
\n
• الدوال — functions.php
\n
• القوالب — header.php، footer.php
\n
• الكائنات — User.php، Database.php
\n

وهنا تأتي الحاجة إلى require و include. فهي حرفيًا "تلصق" محتوى ملف داخل آخر. يعالج PHP الملف المُضمّن كما لو كان كوده مكتوبًا في هذا المكان تمامًا.

2. require vs include: الفرق الرئيسي — رد الفعل على الخطأ

هذه هي النقطة الأهم. احفظها مرة واحدة وإلى الأبد.

include — تضمين مرن

include يحاول تضمين الملف. إذا لم يكن الملف موجودًا أو حدث خطأ، يصدر PHP تحذيرًا (Warning)، لكنه يواصل تنفيذ السكريبت.

<?php\n// include.php\necho "هذا هو include. ";\ninclude 'ملف_غير_موجود.php'; // سيصدر تحذيرًا\necho "السكريبت يواصل العمل!";\n?>\n

النتيجة:

هذا هو include. Warning: include(ملف_غير_موجود.php): failed to open stream...\nالسكريبت يواصل العمل!

أرأيت؟ السكريبت لم يتوقف، بل استمر. هذا مفيد عندما يكون تضمين الملف اختياريًا. مثلاً، إذا كنت تضمّن أداة صغيرة غير ضرورية لعمل الصفحة.

require — تضمين إلزامي

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

<?php\n// require.php\necho "هذا هو require. ";\nrequire 'ملف_غير_موجود.php'; // سيصدر خطأ فادحًا\necho "هذا الكود لن يُنفذ أبدًا!";\n?>\n

النتيجة:

هذا هو require. Fatal error: Uncaught Error: Failed opening required 'ملف_غير_موجود.php'...

السكريبت مات. انتهى الأمر. لا مزيد من التنفيذ.

متى تستخدم كلًا منهما؟

\n
• require — للملفات الحيوية: إعدادات قاعدة البيانات، الكائنات الأساسية، الموجه (Router). إذا لم تكن موجودة، لا يمكن للموقع العمل.
\n
• include — للكتل الاختيارية: القوالب، الأدوات الصغيرة، الإعلانات. إذا لم يتم تضمين الملف، ستظهر الصفحة بدون هذا الجزء.
\n

3. require_once و include_once: الحماية من التكرار

تخيل الآن هذا الموقف. لديك ملف config.php يُعرّف الثوابت والدوال. قم