شرح تنظيم وتقسيم الكود في PHP

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

في هذا الدرس ستتعلم كيف تستخدم include وrequire لبناء مشروع PHP مرتب وسهل الصيانة.

لماذا تنظيم الكود مهم؟

• تقليل تكرار الأكواد بين الصفحات.
• تسهيل الصيانة والتعديل لاحقاً.
• تحسين قابلية القراءة داخل الفريق.
• تقليل احتمالية الأخطاء عند التحديث.

الفرق بين include و require

مثال 1: تقسيم الصفحة إلى Header و Footer

الكود:

<?php
include "header.php";
?>

<h1>مرحباً بك في الصفحة الرئيسية</h1>

<?php
include "footer.php";
?>

بهذه الطريقة لو عدّلت القائمة العلوية في header.php سيتحدث كل الموقع تلقائياً.

مثال 2: متى نستخدم require؟

الكود:

<?php
require "config.php";

// بقية الكود يعتمد على إعدادات config.php
?>

إذا كان الملف أساسياً لعمل الصفحة (مثل الإعدادات أو الاتصال بقاعدة البيانات)، استخدم require.

include_once و require_once

أحياناً نفس الملف قد يُستدعى أكثر من مرة بالخطأ. هنا نستخدم:

• include_once لتحميل الملف مرة واحدة فقط.
• require_once لتحميله مرة واحدة مع إيقاف التنفيذ إذا لم يوجد.

مثال:

<?php
require_once "config.php";
require_once "helpers.php";
?>

هيكلة مشروع PHP بشكل بسيط

project/
  index.php
  about.php
  includes/
    header.php
    footer.php
    config.php
    helpers.php
  assets/
    css/
    js/
    images/

أخطاء شائعة للمبتدئين

• استخدام include لملف أساسي مثل config.php بدل require.
• استدعاء الملف نفسه عدة مرات بدون _once.
• كتابة مسارات نسبية غير دقيقة.
• خلط منطق المعالجة مع HTML بشكل عشوائي في نفس الملف.

تمرين تطبيقي سريع

1. أنشئ ملفات: header.php وfooter.php وconfig.php.
2. استخدم include لإضافة header/footer في صفحتين مختلفتين.
3. استخدم require_once لتحميل config.php.
4. جرّب حذف ملف مطلوب ولاحظ الفرق بين include وrequire.

الأسئلة الشائعة — FAQ

لماذا يجب تنظيم كود PHP؟

لتقليل التكرار وتسهيل الصيانة وتسريع التطوير.

ما الفرق بين include و require؟

include تُظهر Warning وتكمل، require تُظهر Fatal Error وتوقف التنفيذ.

متى أستخدم include_once أو require_once؟

عندما تريد منع تحميل نفس الملف أكثر من مرة.

كيف أقسم المشروع؟

اجعل الأجزاء المشتركة (header/footer/config/helpers) في ملفات مستقلة واستدعها حسب الحاجة.