簡介
PHP提供了錯誤處理和日誌記錄的功能. 這些函數允許你定義自己的錯誤處理規則,以及修改錯誤記錄的方式. 這樣,你就可以根據自己的需要,來更改和加強錯誤輸出資訊以滿足實際需要.
通過日誌記錄功能,你可以將資訊直接發送到其他Log Service器,或者發送到指定的電子郵箱(或者通過郵件網關發送),或者發送到作業系統日誌等,從而可以有選擇的記錄和監視你的應用程式和網站的最重要的部分。
錯誤報表功能允許你自訂錯誤反饋的層級和類型,可以是簡單的提示資訊或者使用自訂的函數進行處理並返回資訊.
範例
下面我們可以看到錯誤處理功能在 PHP 中的使用的樣本。 我們定義錯誤處理函數,記錄錯誤資訊到一個檔案中 (使用以 XML 格式) ,並在發生嚴重邏輯錯誤時,給開發人員寄送電子郵件。
Example #1 在指令碼中使用錯誤控制代碼
<?php // 我們將要定義自己的錯誤處理 error_reporting(0); // 使用者自訂錯誤處理函數 function userErrorHandler($errno, $errmsg, $filename, $linenum, $vars) { // 錯誤發生的時間 $dt = date("Y-m-d H:i:s (T)"); // 定義錯誤字串的關聯陣列 // 在這裡我們只考慮 // E_WARNING, E_NOTICE, E_USER_ERROR, // E_USER_WARNING 和 E_USER_NOTICE $errortype = array ( E_ERROR => 'Error', E_WARNING => 'Warning', E_PARSE => 'Parsing Error', E_NOTICE => 'Notice', E_CORE_ERROR => 'Core Error', E_CORE_WARNING => 'Core Warning', E_COMPILE_ERROR => 'Compile Error', E_COMPILE_WARNING => 'Compile Warning', E_USER_ERROR => 'User Error', E_USER_WARNING => 'User Warning', E_USER_NOTICE => 'User Notice', E_STRICT => 'Runtime Notice', E_RECOVERABLE_ERROR => 'Catchable Fatal Error' ); // 設定要儲存變數跟蹤資訊的錯誤類別 $user_errors = array(E_USER_ERROR, E_USER_WARNING, E_USER_NOTICE); $err = "<errorentry>\n"; $err .= "\t<datetime>" . $dt . "</datetime>\n"; $err .= "\t<errornum>" . $errno . "</errornum>\n"; $err .= "\t<errortype>" . $errortype[$errno] . "</errortype>\n"; $err .= "\t<errormsg>" . $errmsg . "</errormsg>\n"; $err .= "\t<scriptname>" . $filename . "</scriptname>\n"; $err .= "\t<scriptlinenum>" . $linenum . "</scriptlinenum>\n"; if (in_array($errno, $user_errors)) { $err .= "\t<vartrace>" . wddx_serialize_value($vars, "Variables") . "</vartrace>\n"; } $err .= "</errorentry>\n\n"; // for testing // echo $err; // 記錄錯誤資訊到錯誤記錄檔,並在發生關鍵使用者錯誤時寄送電子郵件 error_log($err, 3, "/usr/local/php4/error.log"); if ($errno == E_USER_ERROR) { mail("phpdev@example.com", "Critical User Error", $err); } } function distance($vect1, $vect2) { if (!is_array($vect1) || !is_array($vect2)) { trigger_error("Incorrect parameters, arrays expected", E_USER_ERROR); return NULL; } if (count($vect1) != count($vect2)) { trigger_error("Vectors need to be of the same size", E_USER_ERROR); return NULL; } for ($i=0; $i<count($vect1); $i++) { $c1 = $vect1[$i]; $c2 = $vect2[$i]; $d = 0.0; if (!is_numeric($c1)) { trigger_error("Coordinate $i in vector 1 is not a number, using zero",E_USER_WARNING); $c1 = 0.0; } if (!is_numeric($c2)) { trigger_error("Coordinate $i in vector 2 is not a number, using zero",E_USER_WARNING); $c2 = 0.0; } $d += $c2*$c2 - $c1*$c1; } return sqrt($d); } $old_error_handler = set_error_handler("userErrorHandler"); // 未定義的常量,將產生一個警告 $t = I_AM_NOT_DEFINED; // 定義一些 "載體" $a = array(2, 3, "foo"); $b = array(5.5, 4.3, -1.6); $c = array(1, -3); // 引發一個使用者錯誤 $t1 = distance($c, $b) . "\n"; // 再次引發一個使用者錯誤 $t2 = distance($b, "i am not an array") . "\n"; // 引發一個警告 $t3 = distance($a, $b) . "\n";?>
錯誤處理函數
debug_backtrace — 產生一條回溯跟蹤(backtrace)
debug_print_backtrace — 列印一條回溯。
error_get_last — 擷取最後發生的錯誤
error_log — 發送錯誤資訊到某個地方
error_reporting — 設定應該報告何種 PHP 錯誤
restore_error_handler — 還原之前的錯誤處理函數
restore_exception_handler — 恢複之前定義過的異常處理函數。
set_error_handler — 設定一個使用者定義的錯誤處理函數
set_exception_handler — 設定一個使用者定義的異常處理函數。
trigger_error — 產生一個使用者層級的 error/warning/notice 資訊
user_error — trigger_error 的別名