نصائح تصحيح الأخطاء في Laravel: استخدام Laravel Telescope
المقدمة
Laravel Telescope هو أداة قوية لمراقبة وتصحيح الأخطاء في تطبيقات Laravel. يوفر Telescope واجهة مستخدم رسومية (GUI) تعرض معلومات مفصلة عن طلبات HTTP، استعلامات قاعدة البيانات، الاستثناءات، مهام الجدولة، وغير ذلك الكثير. بفضل Telescope، يمكنك تتبع أداء تطبيقك بشكل أفضل، اكتشاف المشاكل بشكل أسرع، وتحسين تجربة المستخدم الإجمالية. في هذا الدليل، سنستعرض كيفية تثبيت واستخدام Laravel Telescope في بيئة التطوير الخاصة بك.
الخطوة 1: تثبيت Laravel Telescope
لتثبيت Laravel Telescope، تحتاج أولاً إلى التأكد من أن لديك مشروع Laravel جاهز. إذا لم يكن لديك مشروع، يمكنك إنشاء مشروع جديد باستخدام Composer:
composer create-project --prefer-dist laravel/laravel laravel-telescopeبعد ذلك، انتقل إلى مجلد المشروع وقم بتثبيت Telescope باستخدام Composer:
cd laravel-telescope
composer require laravel/telescopeالخطوة 2: إعداد Telescope
بعد تثبيت Telescope، تحتاج إلى نشر ملفاته واستخدام الأمر telescope:install لتثبيت الأصول وتهيئة التطبيق:
php artisan telescope:installسيقوم هذا الأمر بنشر جميع ملفات التكوين المطلوبة وإعداد الموارد اللازمة لـ Telescope. بعد ذلك، قم بتشغيل الترحيلات لإنشاء الجداول الضرورية في قاعدة البيانات:
php artisan migrateالآن، Telescope جاهز للعمل في بيئتك المحلية!
الخطوة 3: الوصول إلى واجهة Telescope
يمكنك الوصول إلى واجهة Telescope من خلال زيارة المسار /telescope في متصفحك المحلي. على سبيل المثال، إذا كان خادم Laravel يعمل على localhost:8000، يمكنك زيارة http://localhost:8000/telescope.
ستظهر لك واجهة Telescope التي تعرض لوحة معلومات مفصلة تشمل الأقسام التالية:
- Requests (الطلبات): تتبع جميع طلبات HTTP الواردة إلى التطبيق.
- Exceptions (الاستثناءات): عرض جميع الاستثناءات التي حدثت في التطبيق.
- Queries (الاستعلامات): تتبع جميع استعلامات قاعدة البيانات، بما في ذلك الاستعلامات البطيئة.
- Jobs (المهام): عرض جميع المهام المجدولة والمهام التي تمت معالجتها.
- Logs (السجلات): عرض سجلات التطبيق بشكل منظم.
- Events (الأحداث): تتبع جميع الأحداث التي تم إطلاقها في التطبيق.
- Mail (البريد): عرض جميع رسائل البريد الإلكتروني المرسلة.
الخطوة 4: تخصيص إعدادات Telescope
يمكنك تخصيص إعدادات Telescope من خلال ملف config/telescope.php. يتضمن هذا الملف العديد من الخيارات لتخصيص السلوك الافتراضي لتطبيق Telescope، مثل مسارات التخزين، تحديد عدد السجلات، وتحديد بيئات العمل.
على سبيل المثال، لتحديد عدد السجلات المحفوظة لكل نوع من الأنشطة، يمكنك تعديل المفتاح limit في ملف config/telescope.php:
'limit' => env('TELESCOPE_LIMIT', 100),يمكنك أيضًا تقييد الوصول إلى Telescope بناءً على بيئات معينة، مما يجعله متاحًا فقط في بيئة التطوير (local) باستخدام خيار env:
'env' => ['local', 'staging'],الخطوة 5: استخدام Telescope لتصحيح الأخطاء وتحسين الأداء
يمكنك استخدام Telescope لتصحيح الأخطاء وتحليل أداء تطبيقك بفعالية. إليك بعض الأمثلة العملية:
1. تتبع طلبات HTTP
في قسم “Requests” في Telescope، يمكنك تتبع جميع طلبات HTTP الواردة، بما في ذلك الوقت المستغرق لكل طلب، الحالة، والعنوان. يمكنك استخدام هذه المعلومات لتحديد الطلبات التي تحتاج إلى تحسين.
2. مراقبة استعلامات قاعدة البيانات
في قسم “Queries”، يمكنك عرض جميع استعلامات قاعدة البيانات التي يتم تنفيذها بواسطة التطبيق. يمكنك تحديد الاستعلامات البطيئة وتحسينها لتحسين أداء التطبيق.
3. تسجيل الاستثناءات والأخطاء
في قسم “Exceptions”، يمكنك عرض جميع الاستثناءات التي حدثت في التطبيق. يمكنك استخدام هذه المعلومات لتحديد وإصلاح الأخطاء بسرعة.
الخطوة 6: تنظيف البيانات القديمة في Telescope
للحفاظ على أداء Telescope بشكل جيد، من المهم تنظيف البيانات القديمة بانتظام. يمكنك القيام بذلك باستخدام الأمر التالي:
php artisan telescope:pruneيمكنك أيضًا جدولة هذه العملية ليتم تنفيذها تلقائيًا باستخدام جدولة Laravel (Scheduler). افتح ملف app/Console/Kernel.php وأضف السطر التالي إلى دالة schedule:
$schedule->command('telescope:prune --hours=48')->daily();سيقوم هذا الأمر بتنظيف البيانات الأقدم من 48 ساعة بشكل يومي.
الخاتمة
Laravel Telescope هو أداة قوية لمراقبة وتصحيح الأخطاء في تطبيقات Laravel. من خلال استخدام Telescope، يمكنك تحسين تجربة التطوير، اكتشاف الأخطاء بشكل أسرع، وتحليل أداء التطبيق بفعالية. تأكد من استخدام Telescope في بيئة التطوير الخاصة بك لتحسين تطبيقاتك والحفاظ على أداء عالي.
لمزيد من المعلومات، يمكنك زيارة المستندات الرسمية للارافيل Telescope.
اترك تعليقاً