ایجاد خطا (trigger_error)
گاهی لازم است خودت «ایجاد خطا» کنی. تابع trigger_error() یک پیام خطای کاربری می سازد. این کار برای تست و کنترل بهتر مفید است.
تعریف و کاربرد
تابع trigger_error() پیام خطا می سازد. این پیام می تواند با «هندلر خطا (Error Handler)» پیش فرض یا سفارشی پردازش شود.
نحو (Syntax)
trigger_error(message, type);
مثال ساده: شرط و ایجاد خطا
اگر عدد بزرگ تر از 10 شد، خطا بساز. این مثل قانون کلاس است.
<?php
$usernum = 12;
if ($usernum > 10) {
trigger_error("Number cannot be larger than 10");
}
?>
نوع خطا: Notice، Warning، Error
می توانی نوع خطا را تعیین کنی. «نوع (Type)» شدت پیام است؛ مثل تذکر تا خطای جدی.
<?php
// پیش فرض: E_USER_NOTICE
trigger_error("This is a notice message");
// هشدار کاربری
trigger_error("This is a warning message", E_USER_WARNING);
// خطای کاربری جدی
trigger_error("This is an error message", E_USER_ERROR);
?>
گام های تمرینی
- شرطی بنویس و ورودی بسنج.
- پیام کوتاه و روشن بساز.
- نوع مناسب را انتخاب کن.
نکات فنی
- بازگشت:
TRUEدر نوع درست؛ در غیر این صورتFALSE. - حداکثر طول پیام: 1024 بایت.
- نسخه PHP: 4.0.1+.
پیوندهای مرتبط
برای «ایجاد خطا» در کنار هندلرها، صفحه تنظیم هندلر خطا و گزارش خطا را ببین. همچنین مرجع بیرونی: W3Schools: trigger_error و W3Schools: Error Reference.
جمع بندی سریع
- از trigger_error برای تست قوانین استفاده کن.
- نوع مناسب را بر اساس شدت انتخاب کن.
- پیام کوتاه و مفید بنویس.
- با هندلر سفارشی، خروجی را کنترل کن.