كل حاجة عن Laravel Debugbar وطريقة استخدامه للمبتدئين

إيه هو Laravel Debugbar؟

Laravel Debugbar هو حزمة (Package) من تطوير Barry vd. Heuvel، واللي بتساعدك تراقب أداء التطبيق أثناء التطوير. بيظهر لك شريط أدوات (Debugbar) تحت الموقع، وبيوفر معلومات عن الاستعلامات، الراوتات، الأخطاء، الأداء، وغيرهم.

ليه أستخدم Laravel Debugbar؟

• متابعة عدد الاستعلامات وزمن تنفيذها.

• التعرف على أخطاء الكود بسهولة.

• تحليل زمن تنفيذ كل جزء في التطبيق.

• استكشاف المسارات (Routes) والـ Views.

طريقة تثبيت Laravel Debugbar

1- تثبيت الحزمة باستخدام Composer

composer require barryvdh/laravel-debugbar --dev

2- تفعيل الحزمة في Laravel (للإصدارات القديمة)

'providers' => [
    Barryvdh\Debugbar\ServiceProvider::class,
],
'aliases' => [
    'Debugbar' => Barryvdh\Debugbar\Facade::class,
],
    

3- نشر ملف الإعدادات (اختياري)

php artisan vendor:publish --provider="Barryvdh\Debugbar\ServiceProvider"

4- التأكد إن التطبيق في وضع "Debug"

APP_DEBUG=true

php artisan config:clear

إيه اللي بيقدمه Laravel Debugbar؟

1- الرسائل (Messages)


 

use Debugbar;
Debugbar::info('دي معلومة');
Debugbar::error('فيه خطأ حصل!');
Debugbar::warning('تحذير مهم...');
Debugbar::addMessage('رسالة مخصصة', 'علامة_مخصصة');
    

2- الـ Timeline (زمن تنفيذ العمليات)

Debugbar::startMeasure('render', 'وقت تنفيذ الـ View');
sleep(1); // محاكاة تأخير
Debugbar::stopMeasure('render');
    

3- مراقبة الأخطاء (Exceptions)

try {
    throw new Exception('فيه مشكلة هنا!');
} catch (Exception $e) {
    Debugbar::addException($e);
}
    

4- عرض القوالب (Views)

بيتم عرض جميع الـ Views المستخدمة والبيانات اللي تم تمريرها لها.

5- تتبع المسارات (Routes)

بيعرض المسار الحالي، الـ Controller، وملف التنفيذ.

6- تتبع استعلامات قاعدة البيانات (Queries)

بيعرض جميع الاستعلامات وزمن تنفيذ كل واحد فيهم، مما يساعد في تحسين الأداء.

7- تتبع الإيميلات (Mail) والطلبات (Request)

• Mail: عرض جميع الإيميلات المرسلة.

• Request: عرض جميع بيانات الطلب الحالي.

8- استعراض الطلبات السابقة

عن طريق الضغط على أيقونة "المجلد"، يمكنك رؤية الطلبات السابقة، وده مفيد جدًا للـ AJAX Requests.

إعدادات إضافية وتحكم متقدم

إيقاف/تشغيل الـ Debugbar وقت التشغيل

Debugbar::enable(); // تفعيل الـ Debugbar
Debugbar::disable(); // تعطيل الـ Debugbar
    

الخلاصة

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