(PHP 4 >= 4.0.1, PHP 5, PHP 7, PHP 8)
trigger_error — 產(chǎn)生一個(gè)用戶(hù)級別的 error/warning/notice 信息
$error_msg
, int $error_type
= E_USER_NOTICE): bool用于觸發(fā)一個(gè)用戶(hù)級別的錯誤條件,它能結合內置的錯誤處理器所關(guān)聯(lián),或者可以使用用戶(hù)定義的函數作為新的錯誤處理程序(set_error_handler())。
該函數在你運行出現異常時(shí),需要產(chǎn)生一個(gè)特定的響應時(shí)非常有用。
error_msg
該 error 的特定錯誤信息,長(cháng)度限制在了 1024 個(gè)字節。超過(guò) 1024 字節的字符都會(huì )被截斷。
error_type
該 error 所特定的錯誤類(lèi)型。僅 E_USER 系列常量對其有效,默認是 E_USER_NOTICE
。
如果指定了錯誤的 error_type
會(huì )返回 false
,正確則返回 true
。
示例 #1 trigger_error() 示例
set_error_handler() 可見(jiàn)到更多詳細的例子。
<?php
if ($divisor == 0) {
trigger_error("Cannot divide by zero", E_USER_ERROR);
}
?>
在 error_msg
里的HTML實(shí)體 并不會(huì )被轉義。
如果錯誤消息要顯示在瀏覽器里,需要對錯誤消息使用 htmlentities()。