تسجيل السجلات لـ PHP: أفضل الحلول والمكتبات

تسجيل السجلات لـ PHP: أفضل الحلول

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

لماذا نحتاج إلى تسجيل السجلات؟

بدون تسجيل السجلات، غالبًا ما يظل المطور "أعمى" عند ظهور المشكلات. نظام تسجيل سجلات عالي الجودة يتيح لك:

• العثور على الأخطاء وإصلاحها بسرعة في بيئة الإنتاج
• جمع الإحصائيات وتحليل الأداء
• ضمان الامتثال لمعايير الأمان (PCI DSS، GDPR)
• تتبع النشاط المشبوه

معيار PSR-3 (واجهة المسجل)

تتبع معظم المكتبات الحديثة لـ PHP معيار PSR-3، الذي يحدد واجهة موحدة للمسجلات. وهذا يسمح باستبدال مكتبة بأخرى بسهولة دون تغيير كود التطبيق.

مستويات تسجيل السجلات الرئيسية وفقًا لـ PSR-3:

• emergency — النظام غير قابل للتشغيل
• alert — يتطلب تدخلًا فوريًا
• critical — خطأ حرج
• error — خطأ لا يتطلب تدخلًا فوريًا
• warning — تحذير
• notice — حدث عادي لكنه مهم
• info — رسالة إعلامية
• debug — معلومات تصحيح الأخطاء

أفضل المكتبات لتسجيل السجلات في PHP

1. Monolog

Monolog هو المعيار الفعلي لتسجيل السجلات في PHP. وهو يدعم PSR-3، ويحتوي على عدد كبير من "المعالجات" (handlers) و"المنسقين" (formatters). يتم تثبيته عبر Composer:

composer require monolog/monolog

مثال على الاستخدام الأساسي:

<?phpuse Monolog\\Logger;use Monolog\\Handler\\StreamHandler;

$log = new Logger('my_app');$log->pushHandler(new StreamHandler('/var/log/app.log', Logger::WARNING));

$log->warning('تحذير: تجاوز حد الطلبات');$log->error('خطأ في الاتصال بقاعدة البيانات', ['db' => 'mysql', 'time' => 0.5]);?>

يدعم Monolog إرسال السجلات إلى الملفات، وقواعد البيانات، وSlack، وTelegram، والبريد الإلكتروني، وSyslog، والعديد من القنوات الأخرى. تسمح البنية المرنة بإنشاء معالجات مخصصة.

2. Analog

Analog هي مكتبة خفيفة وسريعة، تركز على البساطة. لا تتطلب تثبيت تبعيات وهي مثالية للمشاريع الصغيرة.

<?phprequire_once 'Analog.php';

Analog::handler(Analog\\Handler\\File::init('/var/log/app.log'));Analog::log('تم تحميل الصفحة', Analog::INFO);?>

يدعم Analog نفس مستويات تسجيل السجلات مثل PSR-3، لكن له واجهة برمجة تطبيقات خاصة به. للتكامل مع PSR-3، يمكن استخدام الجسر AnalogPSR3.

3. KLogger

KLogger هي مكتبة بسيطة كانت شائعة في السابق. توقف تطويرها الآن، لكنها لا تزال مستخدمة في المشاريع القديمة. مثال:

<?php$log = new Katzgrau\\KLogger\\Logger('/var/log/');$log->info('قام المستخدم بتسجيل الدخول');?>

لا يُنصح بها للمشاريع الجديدة بسبب عدم دعم PSR-3 وعدم وجود تحديثات.

4. Log4php

Log4php هو نسخة من إطار العمل الشهير Log4j بلغة Java. يدعم التكوينات المعقدة عبر XML أو مصفوفات PHP:

<?phprequire_once 'Logger.php';Logger::configure('config.xml');

$logger = Logger::getLogger('main');$logger->error('خطأ حرج');?>

يتمتع Log4php بمنحنى تعلم حاد، لكنه يوفر إمكانيات قوية: التصفية، ومرفقات متعددة، ووحدات ماكرو.