PHP user_error() 函數(shù)

定義和用法

user_error() 函數(shù)創(chuàng)建用戶自定義的錯誤消息。

user_error() 函數(shù)用于在用戶指定的條件下觸發(fā)一個錯誤消息。它可以與內建的錯誤處理程序一起使用，或者與由 set_error_handler() 函數(shù)設置的用戶自定義函數(shù)一起使用。

當您需要在運行腳本時的某個指定條件下自定義錯誤消息時，該函數(shù)很有用。

如果指定了一個不合法的錯誤類型，該函數(shù)返回 FALSE，否則返回 TRUE。

該函數(shù)是 trigger_error() 函數(shù)的別名。

語法

user_error(error_message,error_types)

參數(shù)	描述
error_message	必需。規(guī)定錯誤消息。長度限制為 1024 個字符。
error_types	可選。規(guī)定錯誤消息的錯誤類型。可能的錯誤類型： E_USER_ERROR - 用戶生成的運行時的致命錯誤。不能恢復的錯誤。停止執(zhí)行腳本。 E_USER_WARNING - 用戶生成的運行時的非致命警告。腳本沒有停止執(zhí)行。 E_USER_NOTICE - 默認。用戶生成的運行時的通知。腳本發(fā)現(xiàn)可能是一個錯誤，但也可能在腳本正常運行時發(fā)生。

參數(shù)

描述

error_message

必需。規(guī)定錯誤消息。長度限制為 1024 個字符。

error_types

可選。規(guī)定錯誤消息的錯誤類型。

可能的錯誤類型：

E_USER_ERROR - 用戶生成的運行時的致命錯誤。不能恢復的錯誤。停止執(zhí)行腳本。
E_USER_WARNING - 用戶生成的運行時的非致命警告。腳本沒有停止執(zhí)行。
E_USER_NOTICE - 默認。用戶生成的運行時的通知。腳本發(fā)現(xiàn)可能是一個錯誤，但也可能在腳本正常運行時發(fā)生。

實例

<?php
$test=2;
if ($test>1)
{
user_error("A custom error has been triggered");
}
?>

上面代碼的輸出如下所示：

Notice: A custom error has been triggered
in C:webfoldertest.php on line 6

完整的 PHP Error 參考手冊其他擴展

上一篇：PHP trigger_error() 函數(shù) 下一篇：PHP basename() 函數(shù)