用PHP自定義錯誤處理器處理出錯信息_PHP教程
推薦:PHP網(wǎng)站開發(fā)過程的安全知識1、古老的欺騙SQL語句 在默認模式下,即使是你忘了把php.ini拷到/usr/local/lib/php.ini下,php還是打開magic_quotes_gpc=on。 這樣所有從GET/POST/Cookie來的變量的單引號(')、雙引號()、反斜杠backslash(\)以及空字元NUL (the null byte)都會被加上反斜杠
用PHP自定義錯誤處理器處理出錯信息,如果您是PHP老手,當然知道當PHP腳本出錯時發(fā)生了什么事情。此時PHP解析器將在屏幕上給出錯誤信息,如 Fatal error: Call to undefined function on line 19 --,因此程序在此處終止。這個信息會嚇到客戶,他可能立即打電話和你進行咨詢。
幸運的是,這里有解決辦法。PHP擁有內(nèi)置工具,可以讓開發(fā)人員捕捉腳本錯誤然后將它們轉(zhuǎn)到自定義的錯誤處理器。此時則可以對處理器進行編程顯示更多關(guān)于錯誤的詳細信息。還可以將錯誤寫入文件或數(shù)據(jù)庫以采取補救措施。有時候還可以對處理器編寫程序忽略錯誤消息。
本文中,我將闡述如何使用PHP的錯誤處理API構(gòu)建用戶自定義的錯誤處理器,并且說明如何以簡單而友好的方式顯示和管理腳本的錯誤信息。
錯誤類型和報告級別
我們從最基本的開始。PHP有三種最基本的錯誤類型,從低級到高級分別為:注意、警告和錯誤(或致命錯誤)。通常情況下,注意和警告不會終止程序;但是致命錯誤則是危險故障(例如,調(diào)用一個沒有定義的函數(shù)或參考一個不存在的對象),將導致程序中斷。這些錯誤有可能在啟動、解析、編譯或運行時發(fā)生。
關(guān)鍵字如E_NOTICE, E_ERROR等用于表明錯誤的不同類型和等級。在PHP手冊上可以獲得它們的詳細信息列表。
腳本階段錯誤顯示由error_reporting()函數(shù)進行控制。這一函數(shù)針對不同的錯誤等級設(shè)置不同的參數(shù)。表A給出了使用此函數(shù)報告警告和致命錯誤的腳本程序。
表A
// display warnings and errors
error_reporting(E_WARNING | E_ERROR);
// this will generate a notice, which will never be displayed
echo $undefinedVar;
// this will generate a fatal error, which will be displayed
callUndefFunc();
?>
將表B中的代碼與上面的進行比較發(fā)現(xiàn),Listing B中隱藏錯誤信息甚至隱藏致命信息,使得錯誤信息不會被顯示出來。
表B
// turn off error display
// no errors will be displayed
error_reporting(0);
// this will generate a notice
echo $undefinedVar;
// this will generate a fatal error
callUndefFunc();
?>
表C中的代碼將所有錯誤信息甚至簡單的注意事項都顯示出來:
表C
// all errors will be displayed
error_reporting(E_ALL);
// this will generate a notice
echo $undefinedVar;
// this will generate a fatal error
callUndefFunc();
?>
如以上3個例子所示,error_reporting()函數(shù)在控制錯誤發(fā)生時,在屏幕上顯示內(nèi)容非常重要。這里的關(guān)鍵字是displayed,其表達的意思是錯誤不被顯示而不是錯誤沒有發(fā)生。因此,發(fā)生致命錯誤時(例如不正確的函數(shù)調(diào)用),程序?qū)⒈唤K止;但是,此時沒有任何消息顯示給用戶。
下面的例子(表 D)說明了這種情況:
表D
// no errors will be displayed
error_reporting(0);
// start a task
echo "Starting task...";
// call an undefined function
// a fatal error occurs during task processing
callMe();
// end the task
echo "Successfully completed task...";
?>
在表D中,在調(diào)用echo()函數(shù)時發(fā)生了致命錯誤,程序執(zhí)行時到這點被終止,但是卻沒有任何錯誤消息給出,用戶不知道這種情況還以為程序在正確運行。下面的結(jié)論是非常明顯的:不給出錯誤報告非常危險,因為不論過程是否完成它常導致不正確的結(jié)論。
注意:調(diào)用不帶任何參數(shù)的error_reporting()將返回當前的錯誤報告等級。
自定義錯誤處理器
很明顯,隱藏錯誤報告是不正確的,你肯定想知道有什么其他辦法加以改進。自定義錯誤處理器就是一個很好的能取代PHP默認錯誤處理系統(tǒng)的解決方法。自定義錯誤處理器可以以任何方式設(shè)置處理錯誤信息,包括信息如何顯示。
PHP函數(shù)中,完成這一功能的是set_error_handler()函數(shù)。錯誤發(fā)生時,此函數(shù)被自動調(diào)用,然后給出4個參數(shù):錯誤代碼、錯誤消息、發(fā)生錯誤的腳本名稱和錯誤出現(xiàn)的行,此函數(shù)對錯誤管理負責。
表E給出一個簡單例子:
表E
// define custom handler
set_error_handler('myHandler');
// custom handler code
function myHandler($code, $msg, $file, $line) {
echo "Just so you know, something went wrong at line $line of your script $file. The system says that the error code was $code, and the reason for the error was: $msg. Sorry about this!";
}
// generate a notice
echo $undefVar;
?>
當運行此腳本的時候,會出現(xiàn)下面的信息:
Just so you know, something went wrong at line 11 of your /dev/error1.php. The system says that the error code was 8, and the reason for the error was: Undefined variable: undefVar. Sorry about this!
此時,PHP的默認錯誤處理器被用戶定義的myHandler()函數(shù)所取代,$undefVar變量被激活,PHP通知未定義變量的信息,此信息在運行時引擎產(chǎn)生,然后傳遞給myHandler()函數(shù),同時錯誤發(fā)生的地址也傳遞給此函數(shù)。然后myHandler()函數(shù)輸出友好信息解釋錯誤。
注意:錯誤和致命錯誤很重要,它們會繞過自定義錯誤處理器,然后以PHP默認的錯誤處理機制進行顯示。顯示這些信息可使用前面討論的標準error_reporting()函數(shù)進行控制。
例1:動態(tài)錯誤頁面和e-mail警報
表F給出了另一個范例,當發(fā)生錯誤時,將動態(tài)產(chǎn)生HTML錯誤頁面,并且通過e-mail向Web管理員進行報告。
表F
// define custom handler
set_error_handler('myHandler');
// custom handler code
function myHandler($code, $msg, $file, $line, $context) {
// print error page
echo "";
echo "
Error!
";
echo "";
echo "An error occurred while processing your request. Please visit our home page and try again.";
echo "";
echo "";
// email error to admin
$body = "$msg at $file ($line), timed at " . date ("d-M-Y h:i:s", mktime());
$body .= "\n\n" . print_r($context, TRUE);
mail ("webmaster@domain.dom", "Web site error", $body);
// halt execution of script
die();
}
// generate a notice
echo $undefVar;
?>
這里,自定義的錯誤處理器在遇到錯誤時動態(tài)產(chǎn)生HTML錯誤頁面。此錯誤信息也能被e-mail信息捕獲,然后通過PHP內(nèi)置的mail()函數(shù)發(fā)送給管理員。
這里出現(xiàn)了myHandler()函數(shù)的一個新參數(shù)$context。這是myHandler()函數(shù)的第五個參數(shù),是可選項。它包含了當前變量狀態(tài)的快照。包括對管理員有用的上下文信息,有利于減少調(diào)試時間。
例2:自定義錯誤日志
表G給出了另一個例子,這個例子說明自定義錯誤處理器如何將詳細的錯誤信息輸入到文件。
表G
// define custom handler
set_error_handler('myHandler');
// custom handler code
function myHandler($code, $msg, $file, $line) {
// print error page
echo "";
echo "
Error!
";
echo "";
echo "An error occurred while processing your request. Please visit our home page and try again.";
echo "";
echo "";
// log error to file, with context
$logData = date("d-M-Y h:i:s", mktime()) . ", $code, $msg, $line, $file\n";
file_put_contents("web.log", $logData, FILE_APPEND);
// halt execution of script
die();
}
// generate a warning
echo is_float();
?>
與前面的例子相似,它也產(chǎn)生一個錯誤頁面并且將錯誤數(shù)據(jù)輸入到文件,以利于管理員進行查看。數(shù)據(jù)以CSV格式進行存儲,并且有簡單的數(shù)據(jù)分析和報告。請注意在本例和前面實例中,錯誤處理代碼結(jié)束時調(diào)用die()函數(shù),以確保腳本不再運行。
如上面的范例所示,自定義錯誤處理器允許以友好的方式處理PHP腳本錯誤。并且可以發(fā)揮自己的創(chuàng)造性,不過需要記住的是:任何靈活性的增加都伴隨著開銷和時間的增加。
分享:學習動態(tài)網(wǎng)頁制作PHP技術(shù)的正則表達式正則表達式難于書寫、難于閱讀、難于維護,經(jīng)常錯誤匹配意料不到的文本或者錯過了有效的文本,這些問題都是由正則表達式的表現(xiàn)和能力引起的。每個元字符(metacharacter)的能力和細微差別組合在一起,使得代碼不借助于智力技巧就無法解釋。 許多包含一定特性
- 相關(guān)鏈接:
- 教程說明:
PHP教程-用PHP自定義錯誤處理器處理出錯信息。