شرح صفوف ومحتوى الفقرة
يعتمد تشخيص الأعطال الفعال في بيئة الإنتاج على تدوين سجلات منظمة بدلاً من طباعة الأخطاء على الشاشة. تطبق واجهة Log معيار PSR-3 القياسي، وتوفر دوال لمستويات الخطورة مثل Log::info و Log::warning و Log::error مع قبول مصفوفة ترابطية لبيانات السياق.
- مستويات الخطورة القياسية (PSR-3 Severity Levels): اختر المستوى المناسب للحدث مثل info للعمليات الطبيعية و warning للتحذيرات و error للأعطال.
- مصفوفات السياق (Contextual Arrays): مرر مصفوفة تحتوي على معرف المستخدم أو الطلب كوسيط ثانٍ لتسهيل البحث الجنائي في السجلات.
- مسار الحفظ الافتراضي (Default Storage Location): تُكتب السجلات المحلية داخل ملف storage/logs/laravel.log بالاعتماد على مكتبة Monolog.
PHP
use Illuminate\Support\Facades\Log;
Log::info('Checkout started', ['uid' => $user->id]);
Log::error('Payment gateway timeout', [
'order_id' => $order->id,
]);