PHP set_error_handler() 函數
PHP set_error_handler() 函數

定義和用法
set_error_handler() 函數設置用戶自定義的錯誤處理函數。
該函數用于創建運行期間的用戶自己的錯誤處理方法。
該函數返回舊的錯誤處理程序,如果失敗則返回 NULL。
語法
set_error_handler(error_function,error_types)
參數 | 描述 |
---|---|
error_function | 必需。規定發生錯誤時運行的函數。 |
error_types | 可選。規定在哪個錯誤報告級別會顯示用戶定義的錯誤。默認是 "E_ALL"。可能的錯誤報告級別詳見下面的表格。 |
error_function
語法
error_function(error_level,error_message,
error_file,error_line,error_context)
error_file,error_line,error_context)
參數 | 描述 |
---|---|
error_level | 必需的。規定用戶自定義的錯誤的錯誤報告級別。必須是值數字。可能的錯誤報告級別詳見下面的表格。 |
error_message | 必需的。規定用戶自定義的錯誤的錯誤消息。 |
error_file | 可選。規定發生錯誤的文件名。 |
error_line | 可選。規定發生錯誤的行號。 |
error_context | 可選。規定指向活躍符號表中發生錯誤的數組。換句話說,error_context 將包含一個說明每個變量引發錯誤的存在范圍的數組。 |
錯誤報告級別
值 | 常量 | 描述 |
---|---|---|
2 | E_WARNING | 運行時非致命的錯誤。沒有停止執行腳本。 |
8 | E_NOTICE | 運行時的通知。腳本發現可能是一個錯誤,但也可能在正常運行腳本時發生。 |
256 | E_USER_ERROR | 用戶生成的致命錯誤。這就如同由程序員使用 PHP 函數 trigger_error() 生成的 E_ERROR。 |
512 | E_USER_WARNING | 用戶生成的非致命錯誤。這就如同由程序員使用 PHP 函數 trigger_error() 生成的 E_WARNING。 |
1024 | E_USER_NOTICE | 用戶生成的通知。這就如同由程序員使用 PHP 函數 trigger_error() 生成的 E_NOTICE。 |
4096 | E_RECOVERABLE_ERROR | 可捕獲的致命錯誤。這就如同一個可以由用戶定義的句柄捕獲的 E_ERROR(見 set_error_handler())。 |
8191 | E_ALL | 所有的錯誤和警告的級別,除了 E_STRICT(自 PHP 6.0 起,E_STRICT 將作為 E_ALL的一部分)。 |
提示和注釋
提示:如果使用了該函數,會完全繞過標準的 PHP 錯誤處理函數。如果必要,用戶自定義的錯誤處理程序必須終止腳本(die())。
注釋:
如果在腳本執行前發生錯誤,由于在那時自定義程序還沒有注冊,因此就不會用到這個自定義錯誤處理程序。
實例
<?php
//error handler function
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo " Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError");
$test=2;
//trigger error
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>
//error handler function
function customError($errno, $errstr, $errfile, $errline)
{
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo " Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError");
$test=2;
//trigger error
if ($test>1)
{
trigger_error("A custom error has been triggered");
}
?>
上面代碼的輸出如下所示:
Custom error: [1024] A custom error has been triggered
Error on line 19 in C:webfoldertest.php
Ending Script
Error on line 19 in C:webfoldertest.php
Ending Script

相關文章
- PHP 教程
- PHP 簡介
- PHP 數組
- PHP While 循環
- PHP 多維數組
- PHP array() 函數
- PHP array_fill_keys() 函數
- PHP array_intersect_ukey() 函數
- PHP array_key_exists() 函數
- PHP array_multisort() 函數
- PHP array_push() 函數
- PHP array_reduce() 函數
- PHP array_udiff_uassoc() 函數
- PHP ksort() 函數
- PHP next() 函數
- PHP prev() 函數
- PHP rsort() 函數
- PHP uksort() 函數
- PHP cURL 函數
- PHP 5 Filesystem 函數