مرجع خطا (PHP Error)
توابع «خطا (Error)» برای مدیریت خطا و «لاگ (Log)» هستند. با آن ها سطح گزارش خطا را تنظیم می کنیم، پیام ها را ثبت می کنیم، و حتی خطای دلخواه می سازیم؛ مثل دفتر انضباطی مدرسه برای اتفاقات.
کاربرد کلی توابع خطا
منبع می گوید: این توابع قوانین مدیریت خطا و روش های لاگ را تعیین می کنند. همچنین می توانیم سطح گزارش را شخصی سازی کنیم تا فقط خطاهای مهم را ببینیم.
نمونه سریع: تنظیم سطح و ساخت خطا
<?php
// همه خطاها را گزارش بده
error_reporting(E_ALL);
// ایجاد یک خطای کاربری سطح هشدار
trigger_error("نمونه هشدار کاربری", E_USER_WARNING);
// ارسال پیام خطا به لاگ سرور یا فایل
error_log("A sample error message");
?>
پیکربندی اجرا و php.ini
رفتار خطاها به تنظیمات php.ini وابسته است. گزینه هایی مانند error_reporting، display_errors، log_errors و error_log روی نمایش یا ثبت خطا اثر می گذارند. نمایش خطا در «Production» توصیه نمی شود.
نکته: display_errors فقط برای توسعه روشن بماند. در سایت های واقعی، لاگ بگیرید.
هشدار: اگر directory لاگ قابل نوشتن نباشد، لاگ انجام نمی شود.
سطوح رایج گزارش خطا
ثابت ها طبق مرجع: E_ERROR مرگبار است، E_WARNING هشدار اجرایی است، و E_ALL همه خطاها و هشدارها را فعال می کند.
راهنمای سریع پیاده سازی
- سطح خطا را با
error_reportingتعیین کن. - برای آزمون، با
trigger_errorپیام بساز. - برای ثبت، از
error_logکمک بگیر.
مطالب مرتبط
برای جزئیات توابع: error_reporting، ثبت پیام با error_log، و بازیابی آخرین خطا با error_get_last.
جمع بندی سریع
- سطح گزارش را دقیق تنظیم کن.
- در تولید، خطا را نمایش نده.
- همیشه لاگ منظم داشته باش.
- برای تست، از trigger_error استفاده کن.