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