(PHP 4 >= 4.0.1, PHP 5)
trigger_error — 產(chǎn)生一個用戶級別的 error/warning/notice 信息
說明
bool trigger_error ( string$error_msg
[, int $error_type
= E_USER_NOTICE
] )
用于觸發(fā)一個用戶級別的錯誤條件,它能結合內置的錯誤處理器所關聯(lián),或者可以使用用戶定義的函數(shù)作為新的錯誤處理程序(set_error_handler())。
該函數(shù)在你運行出現(xiàn)異常時,需要產(chǎn)生一個特定的響應時非常有用。
參數(shù)
error_msg
該 error 的特定錯誤信息,長度限制在了1024個字符。超過1024長度的字符都會被截斷。
error_type
該 error 所特定的錯誤類型。僅 E_USER 系列常量對其有效,默認是 E_USER_NOTICE
。
返回值
如果指定了錯誤的 error_type
會返回 FALSE
,正確則返回 TRUE
。
范例
Example #1 trigger_error() 示例
set_error_handler() 可見到更多詳細的例子。
<?php
if ($divisor == 0) {
trigger_error("Cannot divide by zero", E_USER_ERROR);
}
?>
注釋
Warning
在 error_msg
里的HTML實體 并不會被轉義。
如果錯誤消息要顯示在瀏覽器里,需要對錯誤消息使用 htmlentities()。
參見
error_reporting() - 設置應該報告何種 PHP 錯誤 set_error_handler() - 設置一個用戶定義的錯誤處理函數(shù) restore_error_handler() - 還原之前的錯誤處理函數(shù) The 錯誤級別常量