شرح تضمين الملفات في PHP باستخدام include و require

🚀 احتراف تنظيم الكود باستخدام تضمين الملفات (Include Files) في PHP

في هذا الدرس، سنتعرف على واحدة من أكثر المهام شيوعاً في أي موقع إلكتروني، وهي كيفية تنظيم الكود باستخدام تضمين الملفات (Include Files).

إذا قمت بكتابة كود الهيدر والفوتر في كل صفحة بشكل يدوي، فماذا سيحدث لو أردت تغيير كلمة واحدة في القائمة العلوية؟ ستحتاج لتعديل 20 ملفاً! 😱 هذا أمر مرهق وغير احترافي.

هنا يأتي دور تضمين الملفات (Include Files)، وهي ميزة تسمح لك بكتابة الكود مرة واحدة في ملف خارجي، ثم استدعاؤه في أي صفحة تريدها.

📂 ما هو مفهوم تضمين الملفات؟

ببساطة، تضمين الملفات يعني إخبار PHP بما يلي: "اذهب إلى هذا الملف، خذ كل الكود الموجود بداخله، وضعه هنا في هذه الصفحة قبل تنفيذها".

بهذه الطريقة، يمكنك تقسيم موقعك إلى أجزاء صغيرة (Modules)، مما يجعل الكود:

1. أسهل في القراءة: لأن الملفات ستكون قصيرة ومركزة.
2. أسهل في التعديل: تغير ملفاً واحداً، فيتحدث الموقع بالكامل.
3. أقل تكراراً: تتبع مبدأ "Write Once, Use Everywhere".

🛠️ الطريقة الأولى: استخدام include

تُستخدم الدالة include لجلب محتوى ملف آخر. إذا لم يجد PHP الملف المطلوب، سيقوم بإصدار تحذير (Warning)، ولكن سيستمر في تشغيل بقية الصفحة بشكل طبيعي.

مثال عملي: لنفترض أن لدينا ملفاً اسمه header.php يحتوي على ترويسة الموقع:

<?php
// header.php
echo "<h1>Welcome to Codex Academy</h1>";
echo "<p>Learn Programming the Right Way!</p>";
?>

الآن نريد عرض هذه الترويسة في صفحة "الرئيسية" index.php:

<?php
// index.php

// Including the header file
include 'header.php'; 

echo "<h2>This is the Home Page content.</h2>";
?>

النتيجة: ستظهر الترويسة أولاً ثم محتوى الصفحة الرئيسية. 🌟

🛠️ الطريقة الثانية: استخدام require

الدالة require تشبه include تماماً من حيث الوظيفة، ولكن هناك فرقاً جوهرياً في التعامل مع الأخطاء.

إذا استخدمت require ولم يجد PHP الملف، سيعتبر ذلك خطأً قاتلاً (Fatal Error) وسيتوقف الموقع عن العمل تماماً في تلك اللحظة.

متى نستخدم require؟ نستخدمها عندما يكون الملف المضمن "ضرورياً جداً" لعمل الصفحة (مثل ملف الاتصال بقاعدة البيانات أو ملف إعدادات الأمان)، حيث لا يمكن للموقع أن يعمل بدونه.

مثال برمجي:

<?php
// settings.php
$site_name = "Codex Academy";
?>

استدعاؤه في الصفحة:

<?php
// profile.php

// Using require because settings are essential
require 'settings.php'; 

echo "Welcome to " . $site_name;
?>

⚖️ الفرق بين include و require (ملخص سريع)

لكي لا تختلط عليك الأمور، إليك هذا الجدول البسيط:

💡 نصيحة ذهبية

هناك نسخ أخرى من هذه الدوال تسمى include_once و require_once. كلمة once تعني "مرة واحدة فقط". فهي تمنع PHP من تضمين نفس الملف مرتين في الصفحة الواحدة، مما يمنع حدوث أخطاء تكرار تعريف الدوال أو المتغيرات.

مثال على استخدام include_once:

<?php
// This file will be included only once, even if called multiple times
include_once 'header.php';
include_once 'header.php'; // This line will be ignored by PHP
?>