انتقل إلى محتوى الدرس

Triggering Custom Errors error_log تسجيل الرسائل بدالة error_log

تعلّم هرمية الأخطاء وإعدادات التقارير والتسجيل الآمن في PHP بأسلوب PHP 8 الحديث مع أمثلة عملية وتطبيقات تفاعلية.
1 صفوف تعليمية
PHP
0 مشاهدة

شرح صفوف ومحتوى الفقرة

الصف 1 شرح توضيحي

توفر لغة PHP دالتين قياسيتين لتسجيل الأحداث التشخيصية وإطلاق التنبيهات المخصصة من داخل الكود:

  • الدالة error_log(string $message): تكتب رسالة تشخيصية مباشرة في ملف سجل أخطاء الخادم دون إظهار أي شيء في متصفح الزائر.
  • الدالة trigger_error(string $msg, int $level): تطلق تنبيهاً أو تحذيراً مخصصاً للمطورين مثل E_USER_DEPRECATED عند استدعاء دالة قديمة.
PHP
<?php
declare(strict_types=1);

function legacyExport(string $file): bool {
    error_log("[Audit] legacyExport called for: " . $file);
    trigger_error("Use CsvExporter::run() instead", E_USER_DEPRECATED);
    return true;
}
legacyExport("orders.csv");