تنظيم ملفات الموقع ومساراتهاDealing with Website Files and Paths

تعرّفنا في الدرس السابق على امتدادات الملفات ( و و و و) التي يتكون منها الموقع. غير أن أي موقع حقيقي لا يتألف من ملف واحد معزول، بل من عشرات أو مئات الملفات المترابطة داخل مجلدات منظمة. سنتعلم في هذا الدرس كيف يرتب المطورون المحترفون هيكل مجلدات المشروع، ولماذا يبحث خادم الويب تلقائياً عن ملف داخل المجلد الجذري، وكيف نتجنب فخ اختلاف حالة الأحرف بين ويندوز ولينكس، وكيف نربط بين الملفات باستخدام المسارات النسبية والمطلقة مع تأمين الخادم ضد ثغرات التلاعب بالمسارات.

قبل الغوص في التفاصيل الهندسية، استعرض جدول المصطلحات التقنية الأساسية لهذا الدرس:

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

• 1. سهولة النقل الكامل من جهازك إلى خادم الاستضافة (): عندما تكون جميع ملفات المشروع داخل مجلد واحد متكامل، يمكنك رفع المشروع بالكامل إلى أي خادم استضافة دون أن ينكسر رابط صورة أو ملف تنسيق واحد.
• 2. سهولة الصيانة ووضوح العناوين: إن فصل ملفات التنسيق في مجلد ، والسكربتات في ، والصور في يمكّن أي مطور من الوصول إلى الملف المطلوب خلال ثوانٍ.
• 3. العزل الأمني بين الملفات العامة والملفات الحساسة: يتيح التنظيم السليم وضع الملفات العامة فقط داخل مجلد العرض العام، مع إبقاء ملفات الإعدادات السرية (مثل ) خارج نطاق الوصول المباشر للزوار.

تأمل المخطط المعماري الآتي الذي يوضح الهيكلة القياسية لمجلدات وملفات مشروع ويب احترافي:

يرتكز كل موقع ويب على نقطتي انطلاق أساسيتين يعتمد عليهما المتصفح وخادم الويب معاً:

• 1. المجلد الجذري للموقع (): هو المجلد الأب الأعلى الذي يحيط بجميع ملفات ومجلدات الموقع العام (مثل مجلد على جهازك، أو مجلد و على خادم الإنتاج). وعندما يبدأ أي مسار في الويب بشرطة أمامية مفردة فإنه يشير دائماً إلى هذا المجلد الجذري للموقع وليس إلى كامل القرص الصلب في نظام التشغيل.
• 2. ملف البداية الرئيسي (): عندما يزور المستخدم عنوان موقع مثل دون كتابة اسم ملف في نهاية الرابط، يبحث خادم الويب تلقائياً داخل المجلد المطلوب عن ملف يحمل الاسم القياسي ويعرضه كصفحة رئيسية للمجلد.

عند إنشاء مشروع موقع ويب جديد، يُنصح بتوزيع الأصول الثابتة () حسب وظيفتها داخل مجلدات فرعية واضحة بأحرف صغيرة داخل المجلد الجذري:

• مجلد (أو ): يضم جميع ملفات التنسيق مثل .
• مجلد (أو ): يضم ملفات السكربتات التفاعلية مثل .
• مجلد (أو ): تُحفظ فيه الصور الفوتوغرافية والرسوميات المتجهة والأيقونات.
• مجلد : تُحفظ فيه ملفات الخطوط المحلية المضغوطة ().
• مجلد (أو مجلدات فرعية لكل قسم): لتنظيم الصفحات الفرعية الإضافية في المواقع متعددة الصفحات.

إليك النموذج القياسي لشجرة مجلدات مشروع ويب منظم ونظيف:

لأن كل اسم مجلد أو ملف داخل موقعك يتحول مباشرةً إلى جزء من عنوان الرابط () في المتصفح، يلتزم مطورو الويب بقواعد تسمية هندسية صارمة:

1. 1. استخدام الأحرف الإنجليزية الصغيرة دائماً (): اكتب ولا تخلط بين الأحرف الكبيرة والصغيرة لتجنب أخطاء عدم تطابق المسارات على الخوادم.
2. 2. منع المسافات الفارغة تماماً في أسماء الملفات: لا تقبل روابط الويب المسافات الفارغة؛ فإذا سمّيت ملفاً سيضطر المتصفح لتحويل كل مسافة إلى الرمز ليصبح الرابط مشوهاً وعرضة للخطأ ().
3. 3. الفصل بين الكلمات بالشرطة العادية (): استخدم الشرطة العادية لفصل الكلمات مثل لأنها أوضح في القراءة وأفضل لمحركات البحث من الشرطة السفلية .
4. 4. تجنب الرموز المحجوزة في الروابط: ابتعد تماماً عن رموز مثل و و و في أسماء الملفات لأن لها وظائف خاصة محجوزة في بنية عناوين الويب.

من أشهر المشكلات التي تفاجئ مطوري الويب عند رفع أول موقع لهم إلى الاستضافة: «جميع الصور كانت تعمل بشكل ممتاز على جهازي الشخصي، لكن فور رفع الموقع إلى الخادم اختفت بعض الصور وظهر خطأ !»

يكمن السبب الهندسي في اختلاف حساسية حالة الأحرف () بين أنظمة ملفات التشغيل:

• نظاما ويندوز () وماك ( الافتراضي) غير حساسين لحالة الأحرف: لا يفرّق نظام الملفات المحلي في ويندوز وماك بين و؛ فحتى لو اختلفت حالة الحرف الأول بين اسم الملف وبين الكود المكتوب في ، سيعرض جهازك الصورة دون أي اعتراض.
• خوادم لينكس () حساسة بشكل صارم لحالة الأحرف: تعمل الغالبية الساحقة من خوادم الويب العالمية بنظام لينكس الذي يعامل الحرف الكبير والحرف الصغير كرمزين مختلفين تماماً! فإذا كان الملف محفوظاً باسم وطلب الكود ، فسيرد خادم لينكس فوراً بخطأ .

جرّب المحاكي التفاعلي الآتي لمقارنة سلوك نفس الكود على ويندوز محلياً مقابل خادم لينكس في بيئة الإنتاج:

مسار الملف () هو العنوان التوجيهي الدقيق الذي يخبر المتصفح أو نظام التشغيل بسلسلة المجلدات التي يجب عبورها للوصول إلى الملف المطلوب، مثل .

وهناك قاعدة ذهبية حاكمة لكل مسار تكتبه في أكواد و و: الويب يستخدم دائماً الشرطة المائلة للأمام () ولا يستخدم أبداً الشرطة العكسية الخاصة بويندوز ():

• معيار الويب وأنظمة لينكس وماك — الشرطة الأمامية (): تُكتب جميع مسارات الويب والروابط باستخدام الشرطة الأمامية مثل .
• خطأ نسخ مسار القرص المحلي في ويندوز (): يعرض مستكشف ويندوز المسارات بالشرطة العكسية وبحرف القرص . إياك أن تنسخ مساراً محلياً مثل وتضعه في كود موقعك؛ لأن هذا المسار لا وجود له على خادم الاستضافة ولا على أجهزة الزوار، كما أن الرمز يُفسَّر في لغات البرمجة كرمز هروب ().

تأمل المخطط التوضيحي الآتي الذي يقارن عملياً بين اتجاهات الحركة في المسارات النسبية والمسارات المطلقة:

تنقسم المسارات المستخدمة لربط ملفات الموقع إلى ثلاثة أنماط عملية بحسب نقطة الانطلاق:

• 1. المسارات النسبية (): تنطلق من موقع الملف الحالي الذي يُكتب بداخله الكود (ولا تبدأ بشرطة ):
  • في نفس المجلد ( أو ): يبحث عن الملف بجوار الملف الحالي مباشرةً.
  • النزول إلى مجلد فرعي (): يدخل إلى المجلد الفرعي ثم يجلب الملف.
  • الصعود إلى المجلد الأب (): الرمز يصعد خطوة واحدة للأعلى نحو المجلد الأب، وتكراره يصعد خطوتين للأعلى.
• 2. المسار النسبي للجذر (): يبدأ بشرطة أمامية مفردة ، فيتجاهل مكان الملف الحالي ويبدأ الحساب دائماً من قمة المجلد الجذري للموقع على الخادم.
• 3. المسار المطلق الكامل (): يبدأ بالبروتوكول والنطاق الكامل مثل ، ويُستخدم عند الربط بمواقع خارجية أو شبكات توزيع محتوى ().

لاحظ في الكود الآتي كيف تستدعي صفحة فرعية داخل ملفات الموقع بأنواع المسارات الثلاثة:

إن فهمك لآلية عمل الرمز في الصعود إلى المجلد الأب يفسر لك مباشرةً واحدة من أخطر الثغرات الأمنية في تطبيقات الويب، وهي ثغرة التلاعب بمسار الملفات ():

• كيف تنشأ الثغرة برمجياً؟ لنفترض أن موقعاً يوفر رابطاً لتنزيل الكتيبات مثل ، وأن كود الخادم يدمج قيمة المعامل مباشرةً مع مسار المجلد دون فحص.
• استغلال تسلسل الصعود : إذا أرسل مهاجم القيمة أو ، فإن تكرار سيجعل المسار يخرج من مجلد التنزيلات العام صعوداً إلى ملفات النظام الحساسة أو ملف كلمات المرور وإعدادات البيئة ()!
• كيف تحمي الخوادم نفسها من ثغرة ؟
  1. 1. استخدام معرّفات أو قائمة بيضاء (): ربط الملفات المسموح بتنزيلها بمعرّفات رقمية أو أسماء محددة مسبقاً بدلاً من تمرير مسارات مفتوحة في الرابط.
  2. 2. تجريد المسار والاكتفاء بالاسم الأساسي (): استخلاص اسم الملف المجرد وحظر أي مدخلات تحتوي على أو أو .
  3. 3. التحقق من المسار الحقيقي بعد التحليل (): مطابقة المسار الفعلي النهائي والتأكد برمجياً من أنه يقع حصراً داخل المجلد المسموح قبل قراءة أي ملف.