Lorixen.
AR

صفحة خطأ مليئة بالكود على موقعك؟ أطفئ وضع التطوير

باختصار: إذا ظهرت لزائر موقعك عند خطأ ما صفحة مليئة بأسطر برمجية، فيها مسارات ملفات على الخادم واستعلام قاعدة بيانات وربما اسم المستخدم وكلمة مرور قاعدة البيانات، فموقعك يعمل بوضع التطوير. هذا الوضع مفيد للمطور على جهازه، وخطير على الموقع الحي. في Laravel يجب أن يكون APP_DEBUG مضبوطاً على false في بيئة الإنتاج كما يقول التوثيق، وفي PHP يجب أن يكون display_errors مطفأً على الخادم الحي. اعرض للزائر صفحة خطأ عامة، وسجّل التفاصيل في سجلات الخادم فقط.

كيف يحدث هذا؟

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

قد لا يحدث ذلك لأشهر. لكن الأدوات الآلية التي تفحص المواقع بحثاً عن هذه الصفحات تعمل باستمرار، ولا تحتاج أن يزور أحد الموقع عمداً.

ما الذي ينكشف؟

صفحة الخطأ المفصلة قد تعرض، بحسب الإطار والإعدادات:

  • المسار الكامل لملفات الموقع على الخادم.
  • أجزاء من الكود حول السطر الذي فشل.
  • نص استعلام قاعدة البيانات، وأحياناً أسماء الجداول والأعمدة.
  • قيم إعدادات البيئة، وقد يكون منها كلمات مرور أو مفاتيح خدمات خارجية.
  • إصدار اللغة والإطار والخادم.

يحذر توثيق Laravel من أن ضبط APP_DEBUG على true في الإنتاج يعرّضك لخطر كشف قيم إعدادات حساسة للمستخدمين. وتعرض ورقة OWASP عن معالجة الأخطاء أمثلة لأخطاء تكشف تتبع الأخطاء الكامل وإصدار الخادم، وأخرى تكشف استعلام SQL مع مسار تثبيت الموقع.

الإصلاح في Laravel

يشرح توثيق Laravel أن خيار debug في ملف config/app.php يحدد مقدار المعلومات التي تُعرض للمستخدم عند الخطأ، وأنه يعتمد افتراضياً على متغير البيئة APP_DEBUG المخزن في ملف .env. للتطوير المحلي يُضبط على true، وفي بيئة الإنتاج يجب أن يكون false دائماً.

افتح ملف .env على الخادم الحي، لا على جهازك، وتأكد من السطرين: APP_ENV=production وAPP_DEBUG=false. وإن كان الموقع يستخدم تخزين الإعدادات مؤقتاً، فأعد بناءه بعد التعديل حتى تُقرأ القيمة الجديدة.

ونقطة مهمة: ملف .env نفسه يجب ألا يكون قابلاً للتحميل من المتصفح. إذا فتحت رابط موقعك متبوعاً بـ /.env وظهر محتواه، فالمشكلة أخطر من وضع التطوير، لأن كل الإعدادات مكشوفة.

الإصلاح في PHP عموماً

يوضح دليل PHP أن الإعداد display_errors يحدد هل تُطبع الأخطاء على الشاشة كجزء من المخرجات أم تُخفى عن المستخدم، وأن القيمة الافتراضية تعرضها. ويذكر أن ملف php.ini-development المرفق يضبطه على On، وأن php.ini-production يضبطه على Off. وينبه الدليل إلى أن عرض الأخطاء ميزة لدعم التطوير ولا يجب استخدامها على أنظمة الإنتاج المتصلة بالإنترنت.

في الاستضافة المشتركة، تجد هذا الإعداد غالباً في لوحة التحكم ضمن إعدادات PHP. اطفئ عرض الأخطاء، وشغّل تسجيلها في ملف سجل بدلاً من ذلك، حتى لا تخسر المعلومات التي يحتاجها المطور.

ووردبريس أيضاً

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

ماذا يرى الزائر بدلاً من ذلك؟

توصي OWASP بأن يُعاد عند الخطأ غير المتوقع رد عام، وأن تُسجل التفاصيل على الخادم للتحقيق، دون إعادتها للمستخدم. وتذكر أن استخدام رسائل خطأ لا تكشف تفاصيل التنفيذ مهم لتجنب تسريب المعلومات.

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

رمز الحالة الصحيح مع الصفحة العامة

إخفاء التفاصيل لا يعني أن تعيد كل شيء برمز نجاح. توصي ورقة OWASP عموماً باستخدام رموز الفئة 4xx للأخطاء الناتجة عن طلب العميل، مثل الوصول غير المصرح به أو الطلب غير الصحيح، ورموز الفئة 5xx للأخطاء التي تحدث في جهة الخادم. هذا يساعد محركات البحث وأدوات المراقبة على فهم ما يحدث، فلا تُفهرس صفحة خطأ كأنها صفحة عادية، ويصلك تنبيه المراقبة عندما يتعطل الخادم فعلاً. صفحتك العامة الجميلة يمكن أن تُعرض مع أي من هذه الرموز.

واجهات البرمجة وتطبيق الجوال

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

كيف تفحص موقعك الآن؟

  1. افتح رابطاً غير موجود في موقعك، مثل صفحة باسم عشوائي، وانظر ماذا يظهر.
  2. جرّب رابطاً لصفحة موجودة مع معامل غريب في نهايته.
  3. افتح رابط /.env على نطاقك وتأكد أنه لا يعرض شيئاً.
  4. اطلب من المطور أن يريك قيمة APP_DEBUG أو display_errors على الخادم الحي نفسه.
  5. افحص رد واجهة البرمجة عند إرسال طلب ناقص.

بعد الإصلاح

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

مثال توضيحي: مركز تدريب وصفحة خطأ تكشف الإعدادات

لنفترض مركز التدريب المذكور تلقى بلاغاً من طالب أرسل صورة لصفحة خطأ مليئة بالكود. وجد المطور أن APP_DEBUG مضبوط على true على الخادم الحي، فغيّره إلى false، وأعاد بناء الإعدادات، وأضاف صفحة خطأ عامة برقم مرجعي، وغيّر كلمة مرور قاعدة البيانات ومفتاح خدمة البريد احتياطاً.

هذا مثال توضيحي لطريقة المعالجة، دون أرقام أو نتائج مقاسة.

أسئلة شائعة

طلعت صفحة مليانة كود لما صار خطأ بالموقع، هل هاد خطر؟

نعم. غالباً الموقع يعمل بوضع التطوير، وقد يكشف مسارات واستعلامات وإعدادات حساسة. اطفئ عرض الأخطاء فوراً.

شو لازم تكون قيمة APP_DEBUG على الموقع الحي؟

بحسب توثيق Laravel يجب أن تكون false دائماً في بيئة الإنتاج.

إذا أطفأت الأخطاء كيف المطور بيعرف شو صار؟

بتسجيلها في ملف سجل على الخادم، مع رقم مرجعي يظهر للزائر في صفحة الخطأ العامة.

هل لازم أغير كلمات المرور بعد الإصلاح؟

يفضل ذلك إن كانت الصفحات المفصلة ظاهرة لفترة، لأن ما ظهر فيها ربما رآه غيرك.

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

المصادر

WhatsAppاحجز مكالمة