إدارة الأخطاء (Error Handling) ونظام السجلات (Logging)
في عالم البرمجة، الأخطاء ليست عدواً، بل هي إشارات تخبرك بمكان الخلل. يوفر Laravel نظاماً متكاملاً لإدارة هذه الإشارات بطريقة احترافية. فبينما يعرض لك صفحات تفصيلية أثناء التطوير لمساعدتك على الحل، فإنه يقوم بإخفاء هذه التفاصيل عن المستخدم في الموقع الحقيقي، مع تسجيلها في "الصندوق الأسود" (Logs) لتتمكن من مراجعتها لاحقاً وإصلاح المشكلة بصمت.
1. تفعيل وتعطيل وضع التصحيح (Debug Mode)
يتحكم متغير APP_DEBUG في ملف .env في كيفية عرض الأخطاء. من الضروري جداً التأكد من قيمته:
- true: في جهازك الشخصي (التطوير)، لرؤية تفاصيل الخطأ ومكانه بالظبط.
- false: في السيرفر الحقيقي (الإنتاج)، لعرض صفحة خطأ عامة وحماية بيانات كودك من الظهور للعامة.
2. نظام السجلات (Logging)
السجلات هي ملفات نصية تخزن كل ما يحدث في تطبيقك. يمكنك كتابة سجلات خاصة بك لتتبع عمليات معينة باستخدام كلاس Log:
use Illuminate\Support\Facades\Log;
// تسجيل معلومة عادية
Log::info('قام مستخدم بتحديث ملفه الشخصي');
// تسجيل خطأ حرج
Log::error('فشلت عملية الاتصال ببوابة الدفع لطلب رقم: ' . $orderId);يتم تخزين هذه السجلات افتراضياً في مجلد storage/logs/laravel.log.
3. تخصيص صفحات الخطأ (HTTP Exceptions)
بدلاً من عرض صفحات الخطأ الافتراضية للارافيل، يمكنك تصميم صفحاتك الخاصة (مثل 404 أو 500) لتناسب هوية موقعك. كل ما عليك فعله هو إنشاء مجلد باسم errors داخل مجلد الـ views:
resources/views/errors/404.blade.php
عذراً، هذه الصفحة غير موجودة!
العودة للرئيسيةأسئلة شائعة حول الأخطاء والـ Logs
يمكنك استخدام خدمات خارجية مثل **Sentry** أو **Flare**. بمجرد حدوث خطأ عند أي مستخدم، ستصلك رسالة فورية على بريدك أو على Slack تحتوي على جميع تفاصيل الخطأ.
نعم، إذا لم تكن حذراً. يمكنك ضبط الكاش في ملف الإعداد ليقوم بعمل "تدوير" (Rotation) للملفات يومياً وحذف الملفات القديمة تلقائياً لتوفير المساحة.
الدرس القادم
احتراف سطر الأوامر Artisan
تعلمنا الأوامر الجاهزة، الآن سنتعلم كيف نصنع أوامرنا الخاصة (Custom Commands) لتنفيذ مهام دورية أو معالجة بيانات ضخمة بضغطة زر.
تعلم أوامر Artisan المخصصة